التشغيل السريع للغة PHP

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

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

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

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

  • PHP 5.4 أو إصدار أحدث مع تثبيت واجهة سطر الأوامر (CLI) وإضافة JSON
  • أداة إدارة التبعيات Composer مثبَّتة على مستوى العالم
  • مكتبة عميل Google APIs للغة PHP:
    • إذا لم يسبق لك تثبيت مكتبة العميل: 
      composer require google/apiclient:^2.0
    • إذا سبق لك تثبيت مكتبة العميل، ننصحك بتحديثها للتأكّد من حصولك على أحدث الفئات للمكتبة التي تختبرها: 
      composer update google/apiclient --with-dependencies

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. انسخ العيّنة من الرمز البرمجي واحفظها في ملف باسم example.php.

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

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

    php example.php

  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 محدّدًا.

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

  4. كما هو الحال مع المثال السابق، انقر على علامة التبويب PHP، وانسخ عينة تعليمات برمجية، واحفظها في example.php.

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

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

    php example.php

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

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

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

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

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

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