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

أسئلة عامة

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

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

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

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

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

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

https://displayvideo.googleapis.com

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

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

يجب تفويض طلبات "مساحة العرض والفيديو 360 API" للنطاق التالي:

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

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

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

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

يُرجى الرجوع إلى دليل مكتبة العملاء.

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

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

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

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

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

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

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

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

لا تتيح "مساحة العرض والفيديو 360 API" إنشاء مراجع 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 لاستهداف نطاق جغرافي قريب حول إحداثيات خطوط الطول والعرض بشكل مباشر.

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

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

الدعم

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

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