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.