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

**ملاحظة مهمة:** لقد زدنا الحدّ الأقصى لعدد الملفات التي يمكن تحميلها في هذه الميزة التجريبية من خمسة إلى ثلاثين ملف بيانات منظَّم (SDF) في اليوم لكلّ معلِن.

مَن يمكنه الوصول إلى الميزات التجريبية لواجهة برمجة التطبيقات لتحميل ملفات البيانات المنظَّمة (SDF)؟

لا يتوفّر الأسلوب advertisers.sdfuploadtasks.upload إلا لمشاريع على السحابة الإلكترونية من Google Cloud التي تمّت إضافتها إلى القائمة المسموح بها.

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

لا تتوفّر الميزة التجريبية لواجهة برمجة التطبيقات لتحميل ملفات البيانات المنظَّمة (SDF) إلا في الإصدار 4 من Display &Video 360 API.

ما هي إصدارات ملفات البيانات المنظَّمة (SDF) التي تتيحها الميزة التجريبية؟

ننصحك باستخدام الإصدار v9.2 أو إصدار أحدث من ملفات البيانات المنظَّمة (SDF) عند استخدام الميزة التجريبية لواجهة برمجة التطبيقات لتحميل ملفات البيانات المنظَّمة (SDF) .

كيف يمكنني معرفة ما إذا تمّت إضافة مشروعي إلى القائمة المسموح بها؟

أدرِج مفتاح واجهة برمجة تطبيقات تمّ إنشاؤه من مشروعك في عنوان URL هذا، ثمّ انسخ عنوان URL والصِقه في متصفّحك:

**ملاحظة:** لاختيار مفتاح واجهة برمجة تطبيقات من مشروعك، انقر على العنصر API_KEY في عنوان URL. إذا لم يكن هناك مفتاح لواجهة برمجة التطبيقات للمشروع الذي تمّ اختياره، سيُطلب منك إنشاء مفتاح.

https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEY

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

ما هي مكتبات العملاء المتوافقة؟

لا يمكن استخدام الميزات التجريبية لواجهة برمجة التطبيقات Display & Video 360 API إلا من خلال مكتبة عميل واجهة Google API للغة Python للوصول إلى يمكنك الاطّلاع على خطوات الإعداد لـ إنشاء عنصر خدمة مُرخَّص يمكنه استخدام الميزات التجريبية.

هل هناك حدّ أقصى لعدد الإدخالات التي يمكن أن يحتوي عليها ملف البيانات المنظَّمة (SDF)؟

يحتوي ملف البيانات المنظَّمة (SDF) على حدّ أقصى يبلغ 10,000 إدخال. وستؤدي محاولة تحميل ملفات تتجاوز هذا الحدّ إلى ظهور خطأ.

هل هناك حدّ أقصى لعدد ملفات البيانات المنظَّمة (SDF) التي يمكنني تحميلها؟

لا يمكن لمشروع Google Cloud استخدام Display &Video 360 API لتحميل أكثر من ثلاثين ملف بيانات منظَّمة (SDF) في اليوم لكلّ معلِن. يبدأ اليوم في منتصف الليل بالتوقيت الرسمي لمنطقة المحيط الهادئ في الولايات المتحدة (PST).

إذا تعذّر تنفيذ طلب advertisers.sdfuploadtasks.upload أو إذا انتهت عملية التحميل Operation بظهور خطأ، لن يتمّ احتساب المحاولة ضمن الحصة ذات الصلة.

ما هو عدد ملفات البيانات المنظَّمة (SDF) التي يمكن تحميلها في الوقت نفسه؟

لا يمكن لكلّ طلب advertisers.sdfuploadtasks.upload تحميل أكثر من ملف واحد.

لا يمكن لمستخدم واحد في "مساحة العرض والفيديو 360" أن يكون لديه أكثر من 20 مهمة لتحميل ملفات البيانات المنظَّمة (SDF) قيد المعالجة في الوقت نفسه. إذا حمّلت 20 ملفًا، عليك الانتظار إلى أن تنتهي معالجة أحد الملفات قبل تحميل ملف آخر.

لماذا تظهر لي رسالة الخطأ 429؟

إذا ظهرت لك رسالة الخطأ 429، من المحتمل أنّك تجاوزت عدد ملفات البيانات المنظَّمة (SDF) التي يمكنك تحميلها ضمن معلِن واحد في يوم واحد. عليك الانتظار حتى اليوم التالي قبل استخدام Display &Video 360 API لتحميل ملفات بيانات منظَّمة (SDF) إضافية ضمن المعلِن ذي الصلة.

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