التشغيل السريع للغة بايثون

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

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

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

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

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

  • أداة إدارة حزم 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: إعداد مشروعك وبيانات الاعتماد

أنشِئ مشروعًا أو اختَره في Cloud Console. أكمِل المهام التالية في Cloud Console لمشروعك:

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

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

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

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

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

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

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

  1. افتح مستندات طريقة channels.list في واجهة برمجة التطبيقات.

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

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

    صورة تحدّد مكان رابط رمز الرمز البرمجي في الجدول الذي يعرض حالات استخدام مستندات channels.list يحدّد النص البديل لتلك الصورة أنّها رمز للبرنامج ويحدّد حالة الاستخدام المرتبطة بهذا الرابط.

  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 بدلاً من استرداد معلومات عن قناة GoogleDevelopers على 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. كما في المثال السابق، اختَر علامة التبويب Python، وانسخ عينة التعليمات البرمجية، واحفظها في example.py.

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

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

    python example.py

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

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

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

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

    من المفترض أن تتم طباعة الردّ من واجهة برمجة التطبيقات مرة أخرى في STDOUT.

محتوى إضافي للقراءة