للجمهور العام
ما هو أحدث إصدار من واجهة برمجة التطبيقات؟
أحدث إصدار من واجهة برمجة التطبيقات التي يتناولها هذا المستند هو v1beta2.
هذا الإصدار هو إصدار تجريبي خاص متاح للمختبرين الموثوق بهم.
مَن يمكنه الوصول إلى واجهة برمجة التطبيقات؟
لا يتوفّر الوصول إلى v1beta2 إلا لمشاريع وحدة تحكّم واجهة Google API المُدرَجة في القائمة المسموح لها. ويتم التحكّم في الوصول إلى مستندات واجهة برمجة التطبيقات من خلال قائمة منفصلة للمستخدمين المسموح لهم.
كيف يمكنني معرفة ما إذا كان مشروع وحدة التحكّم مُدرَجًا في القائمة المسموح لها؟
اختَر مفتاح واجهة برمجة تطبيقات من مشروعك من خلال النقر على العنصر API_KEY في عنوان URL أدناه. إذا لم يكن هناك مفتاح واجهة برمجة تطبيقات للمشروع المحدّد، سيُطلب منك إنشاء مفتاح. عند الانتهاء، انسخ عنوان URL الناتج والصقه في متصفّحك.
https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEYإذا ظهر لك وصف JSON لواجهة برمجة التطبيقات، يعني ذلك أنّ مشروعك مُدرَج في القائمة المسموح لها. إذا ظهر لك خطأ، يعني ذلك أنّ مشروعك غير مُدرَج في القائمة المسموح لها.
استخدام واجهة برمجة التطبيقات
ما هو عنوان URL الذي يجب استخدامه للوصول إلى واجهة برمجة التطبيقات؟
https://displayvideo.googleapis.com
ما هي طرق المصادقة المتاحة؟
بروتوكول OAuth 2.0 هو طريقة المصادقة الوحيدة المتاحة. يجب تفويض جميع الطلبات للنطاق التالي:
https://www.googleapis.com/auth/display-video
أريد كتابة رمز برمجي. أين يمكنني العثور على مكتبات العملاء؟
Python
يمكن استخدام مكتبة عميل واجهة Google API للغة Python المتاحة للجمهور للوصول إلى واجهة برمجة التطبيقات هذه. لتثبيت المكتبة وإنشاء عنصر خدمة معتمَد، اتّبِع الخطوات التالية:
تثبيت google-api-python-client
pip install --upgrade google-api-python-client
الحصول على عنصر
credentialsمعتمَد يمكنك الاطّلاع على دليل إعداد تطبيقك للحصول على مثال.إنشاء عنصر خدمة معتمَد باستخدام خدمة الاكتشاف
api_key = 'API_KEY' api_name = 'displayvideo' api_url = 'https://%s.googleapis.com/' % api_name api_version = 'v1beta2' discovery_url = ( '%s/$discovery/rest?key=%s&version=%s&labels=%s' % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER') ) service = discovery.build(api_name, api_version, discoveryServiceUrl=discovery_url, http=credentials)