Method: advertisers.assets.upload

يتم تحميل مادة عرض. تعرض رقم تعريف مادة العرض التي تم تحميلها حديثًا إذا نجح ذلك. يجب ألا يتجاوز حجم ملف مادة العرض 10 ميغابايت للصور، و200 ميغابايت لملفات ZIP، و1 غيغابايت للفيديوهات.

يجب استخدامه ضمن عملية تحميل الوسائط المتعددة الأجزاء. يمكنك العثور على أمثلة على استخدام مكتبات العملاء المتوفرة في دليل إنشاء تصميمات الإعلانات.

طلب HTTP

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

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

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

المَعلمات
advertiserId

string (int64 format)

مطلوبة. رقم تعريف المعلن الذي تنتمي إليه مادة العرض هذه.

نص الطلب

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

تمثيل JSON 
{
  "filename": string
}
الحقول
filename

string

مطلوبة. اسم ملف مادة العرض، بما في ذلك امتداد الملف.

يجب أن يكون اسم الملف مرمّزًا بترميز UTF-8 بحجم 240 بايت كحد أقصى.

نص الاستجابة

رسالة رد لـ assets.upload.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "asset": {
    object (Asset)
  }
}
الحقول
asset

object (Asset)

مادة العرض التي تم تحميلها، إذا كانت ناجحة.

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.