التشغيل السريع Python

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

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

ملاحظة: بشكلٍ عام، يمكنك اتّباع التعليمات الواردة في المثال الأول لأي حالة استخدام تستخدم مفتاح واجهة برمجة تطبيقات أو تعليمات المثال الثاني لأي حالة استخدام تتطلّب تفويضًا باستخدام OAuth 2.0. اطّلِع على أداة حالات الاستخدام ونماذج التعليمات البرمجية للحصول على المزيد من الأمثلة.

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

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

• Python 2.7 أو Python 3.5 أو إصدار أحدث

• أداة إدارة الحزم pip

• مكتبة برامج "Google APIs" للغة Python:

  pip install --upgrade google-api-python-client
  

• المكتبات google-auth-oauthlib وgoogle-auth-httplib2 لتفويض المستخدم.

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

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

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

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

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

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

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

      نزِّل ملف JSON الذي يحتوي على بيانات اعتماد OAuth 2.0. يحتوي الملف على اسم مثل client_secret_CLIENTID.json، حيث CLIENTID هو معرّف العميل لمشروعك.

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

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

1. افتح وثائق طريقة channels.list لواجهة برمجة التطبيقات.

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

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

   

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

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

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

      

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

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

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

7. شغّل النموذج من سطر الأوامر. في دليل العمل، يمكنك تشغيل:

   python example.py

8. يجب أن ينفذ النموذج الطلب ويطبع الرد على STDOUT.

الخطوة 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.

      

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

   في الرمز، ابحث عن سلسلة YOUR_CLIENT_SECRET_FILE.json واستبدلها بموقع الملف السري للعميل الذي نزّلته في الخطوة 1 من دليل البدء السريع هذا.

5. شغّل النموذج من سطر الأوامر. في دليل العمل، يمكنك تشغيل:

   python example.py

6. انسخ عنوان URL من وحدة التحكّم وافتحه في المتصفّح.

   إذا لم تكن قد سجلت الدخول فعلاً إلى حسابك في Google، فستتم مطالبتك بتسجيل الدخول. إذا سجلت الدخول إلى حسابات متعددة في Google، فسيُطلب منك تحديد حساب واحد لاستخدامه للتفويض.

7. انقر على الزر لمنح تطبيقك إمكانية الوصول إلى النطاقات المحددة في نموذج الشفرة.

8. انسخ رمز المصادقة من المتصفح والصقه في الوحدة الطرفية. يمكنك بعد ذلك إغلاق علامة تبويب المتصفح المستخدمة في تدفق المصادقة.

   يجب طباعة استجابة واجهة برمجة التطبيقات مرة أخرى إلى STDOUT.

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

• وثائق مساعدة Google Developers Console
• مكتبة برامج "Google APIs" للغة Python
• مستندات PyDoc لواجهة برمجة التطبيقات لبيانات YouTube
• مستندات مرجعية لواجهة برمجة التطبيقات لبيانات YouTube