Method: advertisers.assets.upload

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

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

طلب HTTP

  • معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
    POST https://displayvideo.googleapis.com/upload/v5/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 Overview.