الأسئلة الشائعة

بنود عامة

ما هو أحدث إصدار من واجهة برمجة التطبيقات؟

أحدث إصدار من واجهة برمجة التطبيقات الذي يتناوله هذا المستند هو v1beta2. هذا الإصدار هو إصدار تجريبي خاص، وهو متاح للمختبِرين الموثوق بهم.

مَن يمكنه الوصول إلى واجهة برمجة التطبيقات؟

لا يتوفر إذن وصول v1beta2 إلا للسماح بمشاريع وحدة تحكُّم Google APIs المدرَجة. تتحكّم قائمة المستخدمين المسموح بها منفصلة في الوصول إلى مستندات واجهة برمجة التطبيقات.

كيف يمكنني معرفة ما إذا تم السماح بإدراج مشروع وحدة التحكم الخاص بي؟

اختَر مفتاح واجهة برمجة التطبيقات من مشروعك من خلال النقر على عنصر 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 المتاحة للجميع للوصول إلى واجهة برمجة التطبيقات هذه. لتثبيت المكتبة وإنشاء عنصر خدمة معتمد، يُرجى اتّباع الخطوات أدناه.

  1. تثبيت google-api-python-client

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

  2. الحصول على عنصر credentials معتمد يمكنك الاطّلاع على دليل إعداد التطبيق للتعرّف على مثال.

  3. يمكنك إنشاء عنصر خدمة معتمَد باستخدام خدمة الاكتشاف.

    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)