Method: advertisers.assets.upload

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

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

طلب HTTP

  • عنوان URI للتحميل، لطلبات تحميل الوسائط:
    POST https://displayvideo.googleapis.com/upload/v3/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.