Method: advertisers.assets.upload

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

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

طلب HTTP

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