التشغيل السريع باستخدام JavaScript

يشرح دليل البدء السريع هذا كيفية إعداد صفحة بسيطة ترسل طلبات إلى YouTube Data API. يشرح دليل البدء السريع هذا كيفية إنشاء طلبين من واجهة برمجة التطبيقات:

  1. وستستخدم مفتاح واجهة برمجة التطبيقات الذي يحدد تطبيقك، لاسترداد معلومات حول قناة مطوري برامج Google على YouTube.
  2. عليك استخدام معرّف عميل OAuth 2.0 لإرسال طلب مفوّض باسترداد معلومات حول قناتك على YouTube.

المتطلبات الأساسية

لتنفيذ هذا التشغيل السريع، ستحتاج إلى:

  • Python 2.4 أو إصدار أحدث (لتوفير خادم ويب)
  • الدخول إلى الإنترنت ومتصفح الويب.
  • حساب Google.

الخطوة 1: إعداد مشروعك وبيانات الاعتماد

أنشئ مشروعًا أو حدّده في وحدة تحكم واجهة برمجة التطبيقات. أكمِل المهام التالية في وحدة تحكم واجهة برمجة التطبيقات لمشروعك:

  1. في لوحة المكتبة، ابحث عن الإصدار الثالث من YouTube Data API. انقر على قائمة واجهة برمجة التطبيقات هذه وتأكد من تمكين واجهة برمجة التطبيقات لمشروعك.

  2. في لوحة بيانات الاعتماد، أنشئ بيانات اعتماد:

    1. إنشاء مفتاح واجهة برمجة تطبيقات ستستخدم مفتاح واجهة برمجة التطبيقات لإجراء طلبات البيانات من واجهة برمجة التطبيقات التي لا تتطلب تفويض المستخدم. على سبيل المثال، لا تحتاج إلى تفويض المستخدم لاسترداد معلومات حول قناة YouTube عامة.

    2. إنشاء معرِّف عميل OAuth 2.0 اضبط نوع التطبيق على تطبيق ويب. عليك استخدام بيانات اعتماد OAuth 2.0 للطلبات التي تتطلب تفويض المستخدم. على سبيل المثال، تحتاج إلى إذن المستخدم لاسترداد معلومات حول قناة المستخدم التي تمت مصادقتها حاليًا على YouTube.

      في حقل مصادر JavaScript المعتمدة، أدخِل عنوان URL http://localhost:8000. يمكنك ترك حقل معرّفات الموارد المنتظمة (URI) المُعتمَدة لإعادة التوجيه فارغًا.

الخطوة 2: إعداد النموذج وتشغيله

استخدم أداة مستكشف واجهات برمجة التطبيقات في اللوحة الجانبية للحصول على نموذج لشفرة لاسترداد معلومات حول قناة GoogleDevelopers على YouTube. يستخدم هذا الطلب مفتاح واجهة برمجة تطبيقات لتعريف تطبيقك، ولا يتطلب إذنًا من المستخدم أو أي أذونات خاصة من المستخدم الذي يشغّل النموذج.

  1. افتح وثائق طريقة channels.list لواجهة برمجة التطبيقات.
  2. وفي تلك الصفحة، يحتوي قسم "حالات الاستخدام الشائعة" على جدول يوضح عدة طرق شائعة لاستخدام هذه الطريقة. أول قائمة بيانات في الجدول هي لعرض النتائج بحسب معرّف القناة.

    انقر على رمز الرمز للقائمة الأولى لفتح وملء مستكشف واجهات برمجة التطبيقات بملء الشاشة.

    صورة تحدد موقع رابط رمز الرمز في الجدول الذي يدرج حالات الاستخدام لوثائق channel.list. يحدد النص البديل لهذه الصورة الصورة كرمز شفرة ويحدد حالة الاستخدام المقترنة بذلك الرابط.

  3. يعرض الجانب الأيمن من مستكشف واجهات برمجة التطبيقات في وضع ملء الشاشة ما يلي:

    1. أسفل العنوان معلمات الطلب، توجد قائمة بالمعلمات التي تتوافق معها هذه الطريقة. يجب تعيين قيم المعلمات part وid. إن قيمة المعلمة id، UC_x5XG1OV2P6uZZ5FSM9Ttw، هي معرف قناة GoogleDevelopers على YouTube.

    2. أسفل المعلّمات، يتوفّر قسم بعنوان بيانات الاعتماد. يجب أن تعرض القائمة المنسدلة في هذا القسم القيمة مفتاح واجهة برمجة التطبيقات. يستخدم مستكشف واجهات برمجة التطبيقات بيانات الاعتماد التجريبية بشكل افتراضي لتسهيل عملية البدء. ولكن ستستخدم مفتاح واجهة برمجة التطبيقات الخاص بك لتشغيل النموذج محليًا.

      صورة تعرض "بيانات الاعتماد" في مستكشف واجهات برمجة التطبيقات بملء الشاشة
والقائمة المنسدلة مع تحديد خيار "مفتاح واجهة برمجة التطبيقات".

  4. يعرض الجانب الأيسر من مستكشف واجهات برمجة التطبيقات في وضع ملء الشاشة علامات تبويب بها نماذج شفرات في لغات مختلفة. حدد علامة التبويب جافا سكريبت.

  5. انسخ نموذج الرمز واحفظه في ملف باسم example.html.

  6. في النموذج الذي نزّلته، ابحث عن سلسلة YOUR_API_KEY واستبدلها بمفتاح واجهة برمجة التطبيقات الذي أنشأته في الخطوة 1 من قائمة البدء السريع هذه.

  7. ابدأ تشغيل خادم الويب باستخدام الأمر التالي من دليل العمل:

    Python 2.x

    python -m SimpleHTTPServer 8000
    

    Python

    python -m http.server 8000
    
  8. افتح ملف example.html في متصفحك. افتح أيضًا أدوات مطوّري البرامج في المتصفح، مثل "أدوات مطوّري البرامج" في متصفح Chrome.

    1. انقر على الزر تحميل في الصفحة لتحميل مكتبة عميل "Google APIs" للغة JavaScript. بعد النقر على الزر، يجب أن تعرض وحدة تحكم مطوّري البرامج ملاحظة تشير إلى أنه تم تحميل عميل GAPI.

    2. انقر على الزر تنفيذ لإرسال طلب البيانات من واجهة برمجة التطبيقات. ومن المفترض أن تعرض وحدة تحكم مطوّر البرامج استجابة واجهة برمجة التطبيقات.

الخطوة 3: تنفيذ طلب مصرّح به

في هذه الخطوة، ستعدّل نموذج الشفرة بحيث تسترد معلومات حول قناتك على YouTube بدلاً من جلب معلومات حول قناة Google Developers على YouTube. ويتطلب هذا الطلب تفويض المستخدم.

  1. ارجع إلى وثائق طريقة channels.list لواجهة برمجة التطبيقات.

  2. في القسم "حالات الاستخدام الشائعة"، انقر على رمز الرمز لبطاقة البيانات الثالثة في الجدول. حالة الاستخدام هذه هي استدعاء طريقة list لـ "قناتي".

  3. مرة أخرى، في الجانب الأيمن من مستكشف واجهات برمجة التطبيقات في وضع ملء الشاشة، سترى قائمة من المعلمات متبوعة بقسم بيانات الاعتماد. ومع ذلك، فهناك تغييران من المثال الذي استرددت من خلاله المعلومات حول قناة GoogleDevelopers:

    1. في قسم المعلّمات، بدلاً من ضبط قيمة المعلَمة id، يجب ضبط قيمة المعلَمة mine على true. يؤدي ذلك إلى توجيه خادم واجهة برمجة التطبيقات لاسترداد معلومات حول قناة المستخدم الذي تمت مصادقته حاليًا.

    2. في قسم بيانات الاعتماد، يجب أن تحدد القائمة المنسدلة خيار Google OAuth 2.0.

      بالإضافة إلى ذلك، إذا نقرت على الرابط عرض النطاقات، يجب التحقق من النطاق https://www.googleapis.com/auth/youtube.readonly.

      صورة تعرض النطاقات في مستكشف واجهات برمجة التطبيقات في وضع ملء الشاشة وخيار استخدام بيانات اعتماد "Google OAuth 2.0".

  4. كما هو الحال مع المثال السابق، حدّد علامة التبويب جافا سكريبت، وانسخ نموذج الشفرة، واحفظه في example.html.

    في الرمز، ابحث عن سلسلة YOUR_CLIENT_ID واستبدلها بمعرِّف العميل الذي أنشأته في الخطوة 1 من قائمة البدء السريع هذه.

  5. ابدأ تشغيل خادم الويب باستخدام الأمر التالي من دليل العمل:

    Python 2.x

    python -m SimpleHTTPServer 8000
    

    Python

    python -m http.server 8000
    
  6. انتقِل إلى ملف http://localhost:8000/example.html في متصفِّحك. افتح أدوات مطوّري البرامج في المتصفح، مثل "أدوات مطوّري البرامج" في متصفح Chrome.

  7. انقر على الزر تفويض وتحميل في الصفحة لتحميل مكتبة برامج Google APIs لجافا سكريبت وبدء تدفق التفويض. ستتم مطالبتك بمنح الإذن للتطبيق بقراءة بيانات من حسابك في YouTube.

    إذا منحت الإذن، فمن المفترض أن تعرض وحدة تحكم مطوّري البرامج رسائل تشير إلى نجاح تسجيل الدخول وأنه تم تحميل عميل واجهة برمجة التطبيقات.

  8. انقر على الزر تنفيذ لإرسال طلب البيانات من واجهة برمجة التطبيقات. ومن المفترض أن تعرض وحدة تحكم مطوّر البرامج استجابة واجهة برمجة التطبيقات.

قراءات إضافية