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

بنود عامة

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

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

هل يمكنني استرداد بيانات الأداء باستخدام واجهة برمجة التطبيقات هذه؟

لا، استخدِم Bid Manager API لإنشاء تقارير "مساحة العرض والفيديو 360" بلا إنترنت واستردادها وتنفيذها.

استخدام واجهة برمجة التطبيقات

ما هو عنوان URL الذي أستخدمه للوصول إلى واجهة برمجة التطبيقات؟

https://displayvideo.googleapis.com

ما هي طرق المصادقة المتاحة؟

‫OAuth 2.0 هي طريقة المصادقة الوحيدة المتوافقة.

يجب أن تكون طلبات البيانات من واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" مصرّحًا بها للنطاق التالي:

  • https://www.googleapis.com/auth/display-video

يجب أيضًا تفويض الطلبات المرسَلة إلى خدمة users للسماح بالوصول إلى النطاق الإضافي التالي:

  • https://www.googleapis.com/auth/display-video-user-management

أريد كتابة رمز برمجي. أين يمكنني العثور على مكتبات العملاء؟

راجِع دليل مكتبة العميل.

ماذا لو لم أرغب في استخدام مكتبة عملاء؟

ننصحك باستخدام إحدى مكتبات البرامج الخاصة بنا، ولكن يمكنك أيضًا التفاعل مع Display & Video 360 API باستخدام طلبات HTTP مباشرةً.

إنّ بعض الطرق الأكثر تعقيدًا، مثل advertisers.assets.upload وmedia.upload، يصعب تحويلها مباشرةً إلى طلبات HTTP. اطّلِع على أمثلة على طلبات HTTP لهذه الطرق باستخدام cURL في دليلَي تصميم الإعلان وعروض الأسعار المخصّصة.

ما هي أذونات "مساحة العرض والفيديو 360" التي أحتاج إليها؟

لاستخدام واجهة برمجة التطبيقات Display & Video 360 API، يجب أن يكون حساب Google الذي يُستخدم للمصادقة هو حساب مستخدم في "مساحة العرض والفيديو 360" يمكنه الوصول إلى الشركاء أو المعلِنين المعنيّين.

يجب أن يكون لدى مستخدِم "مساحة العرض والفيديو 360" أحد أدوار المستخدِم التالية ليتمكّن الشركاء أو المعلِنون المعنيّون من تنفيذ الخطوات التالية:

  • للقراءة فقط: استرداد الموارد باستخدام طلبات get أو list، باستثناء موارد user
  • عادي: استرداد الموارد وإنشاؤها وتعديلها استرداد user الموارد التي تتضمّن أذونات للشركاء أو المعلِنين نفسهم
  • المشرف: استرداد الموارد وإنشاؤها وتعديلها استرداد وإنشاء منح الوصول إلى user الموارد للشركاء أو المعلِنين الذين تديرها

كيف يمكنني تعديل موارد YouTube والشركاء باستخدام واجهة برمجة التطبيقات؟

لا تتيح واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360 " إنشاء موارد YouTube والشركاء أو تعديلها. يمكنك إنشاء موارد YouTube والشركاء أو تعديلها بشكل مجمّع من خلال تحميلملفّات البيانات المنظَّمة (SDF) في واجهة "مساحة العرض والفيديو 360 ". للحصول على مزيد من التفاصيل حول كيفية استخدام ميزة تحميل SDF، يمكنك الاطّلاع على صفحة الدليل التي تتضمّن مراجع YouTube والشركاء.

كيف يمكنني استهداف المواقع الجغرافية؟

يمكن تحديد الاستهداف الجغرافي للعناصر باستخدام أنواع الاستهداف التالية:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

استرجع أرقام تعريف خيارات الاستهداف لأنواع الاستهداف الثلاثة الأولى باستخدام targetingTypes.targetingOptions.search. استرداد موارد قائمة المواقع الجغرافية وإدارتها باستخدام خدمة advertisers.locationLists

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

أرى أنّه يمكنني تنزيل ملفات البيانات المنظَّمة (SDF) باستخدام واجهة برمجة التطبيقات، ولكن كيف يمكنني تحميلها؟

لا تتيح واجهة برمجة التطبيقات Display & Video 360 API تحميل ملفّات SDF. ننصحك بإدارة الموارد من خلال طُرق CREATE وPATCH وDELETE التي تقدّمها واجهة برمجة التطبيقات بدلاً من ذلك. إذا كنت لا تزال تريد إدارة الموارد باستخدام ملفات SDF، يمكن تعديل هذه الملفات في واجهة "مساحة العرض والفيديو 360".

الدعم

هل هناك أي مشاكل أو قيود معروفة في واجهة برمجة التطبيقات؟

هناك حدود لعدد الطلبات التي يمكن لمشروعك إرسالها في الثانية، وقد تم تحديدها في دليل حدود الاستخدام.