مَن يمكنه الوصول إلى الميزات التجريبية لواجهة برمجة التطبيقات الخاصة بتحميل ملفات البيانات المنظَّمة (SDF)؟
لا تتوفّر طريقة advertisers.sdfuploadtasks.upload إلا لمشاريع Google Cloud المُضافة إلى قائمة مسموح بها.
ما هي إصدارات واجهة برمجة التطبيقات التي تتيح استخدام ميزات الإصدار التجريبي؟
لا تتوفّر النسخة التجريبية من واجهة برمجة التطبيقات لتحميل ملفات SDF إلا في الإصدار 4 من Display & Video 360 API.
ما هي إصدارات SDF التي يتيحها البرنامج التجريبي؟
ننصحك باستخدام الإصدار v9.2 من "تنسيق بيانات Google" عند استخدام الإصدار التجريبي من واجهة برمجة التطبيقات لتحميل "تنسيق بيانات Google". راجِع دليل نقل البيانات إلى الإصدار 9 إذا كنت تنقل البيانات من إصدار أقدم من الإصدار 9 من SDF.
كيف يمكنني معرفة ما إذا تمت إضافة مشروعي إلى قائمة السماح؟
أدرِج مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه من مشروعك في عنوان URL هذا، ثم انسخ عنوان URL والصِقه في المتصفّح:
https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEYإذا ظهر لك وصف لواجهة برمجة التطبيقات بتنسيق JSON، يعني ذلك أنّه تمت إضافة مشروعك إلى القائمة المسموح بها. إذا ظهر لك خطأ، يعني ذلك أنّه لم تتم إضافة مشروعك.
ما هي مكتبات البرامج المتوافقة مع واجهة برمجة التطبيقات؟
يمكن استخدام مكتبة برامج Google API للغة Python فقط للوصول إلى الميزات التجريبية في { api_name }. اطّلِع على خطوات الضبط لإنشاء عنصر خدمة معتمَد يمكنه الاستفادة من الميزات التجريبية.
هل هناك حدود لعدد الإدخالات التي يمكن أن يتضمّنها ملف SDF؟
يبلغ الحدّ الأقصى لعدد الإدخالات في ملفات SDF 10,000 إدخال. وستؤدي محاولة تحميل ملفات تتجاوز هذا الحد إلى حدوث خطأ.
هل هناك حدود لعدد ملفات بيانات التغذية الذكية التي يمكنني تحميلها؟
يمكن لمشروع على Google Cloud استخدام Display & Video 360 API لتحميل ثلاثين ملف بيانات منظَّمة (SDF) فقط لكل معلِن في اليوم. يبدأ اليوم عند منتصف الليل بتوقيت المحيط الهادئ في الولايات المتحدة (PST).
في حال تعذُّر تنفيذ طلب advertisers.sdfuploadtasks.upload أو انتهاء عملية تحميل `Operation بحدوث خطأ، لن يتم احتساب المحاولة ضمن الحصة ذات الصلة.
كم عدد ملفات SDF التي يمكن تحميلها في المرة الواحدة؟
يمكن لكل طلب advertisers.sdfuploadtasks.upload تحميل ملف واحد فقط.
يمكن لمستخدم واحد في "مساحة العرض والفيديو 360" أن ينفّذ 20 مهمة تحميل بتنسيق SDF في المرة الواحدة. إذا حمّلت 20 ملفًا، عليك الانتظار إلى أن تنتهي معالجة أحد الملفات قبل تحميل ملف آخر.
لماذا تظهر لي رسالة الخطأ 429؟
إذا تلقّيت الخطأ 429، من المحتمل أنّك تجاوزت عدد ملفات SDF التي يمكنك تحميلها ضمن حساب أحد المعلِنين في يوم واحد. انتظِر حتى اليوم التالي قبل استخدام واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360" لتحميل ملفات بيانات مهيكلة إضافية ضمن المعلِن ذي الصلة.
إذا كنت تعتقد أنّك تتجاوز حصة مختلفة، يمكنك الاطّلاع على حدود الاستخدام العادية لواجهة برمجة التطبيقات لمعرفة تعريفات الحدود، وعلى دليل تحسين الحصة لمعرفة أفضل الممارسات بشأن الحدّ من استخدام الحصة.