Method: advertisers.sdfuploadtasks.upload

لإنشاء مهمة تحميل ملف SDF عرض Operation

مهمة تحميل ملف SDF هي عملية طويلة وغير متزامنة. نوع metadata لهذه العملية هو SdfUploadTaskMetadata. إذا كان الطلب ناجحًا، يكون نوع response للعملية هو SdfUploadTask. لن تتضمّن الاستجابة الملفات الناتجة، والتي يمكن استردادها بعد ذلك باستخدام media.download.

يمكن استرداد حالة العملية باستخدام sdfuploadtask.operations.get.

يمكن العثور على أي أخطاء في error.message. يُرجى العِلم أنّه من المتوقّع أن تكون قيمة error.details فارغة.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، للطلبات المتعلّقة بالبيانات الوصفية فقط:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
advertiserId

string (int64 format)

مطلوب. رقم تعريف المعلِن المطلوب تحميل ملف SDF له.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
الحقول
filename

string

مطلوب. اسم ملف مادة العرض، بما في ذلك امتداد الملف يجب أن يكون اسم الملف بترميز UTF-8 وبحجم أقصاه 240 بايت.
sdfVersion

enum (SdfVersion)

مطلوب. إصدار SDF للملف الذي تم تحميله في حال ضبطها على SDF_VERSION_UNSPECIFIED، سيتم ضبطها تلقائيًا على الإصدار الذي حدّده المعلِن المحدّد. يكتسب المعلِن إصدار SDF من شريكه ما لم يتم ضبطه على خلاف ذلك.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.