Method: advertisers.assets.upload

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

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

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    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.