Method: advertisers.adAssets.upload

تحميل مادة عرض إعلان وإنشاؤها

تعرِض هذه السمة رقم تعريف مادة عرض الإعلان التي تم إنشاؤها حديثًا في حال نجاح العملية.

يتيح فقط تحميل مواد العرض التي تتضمّن AdAssetType AD_ASSET_TYPE_IMAGE.

طلب HTTP

  • عنوان URI للتحميل، لطلبات تحميل الوسائط:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • معرّف الموارد المنتظم للبيانات الوصفية، للطلبات التي تتضمّن البيانات الوصفية فقط:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
advertiserId

string (int64 format)

الحقل مطلوب. رقم تعريف المعلِن الذي تنتمي إليه مادة عرض الإعلان هذه.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "filename": string,
  "adAssetType": enum (AdAssetType)
}
الحقول
filename

string

الحقل مطلوب. اسم ملف مادة عرض الإعلان، بما في ذلك إضافة الملف

يجب أن يكون اسم الملف بترميز UTF-8 وبحجم أقصى يبلغ 240 بايت.
adAssetType

enum (AdAssetType)

الحقل مطلوب. نوع مادة عرض الإعلان.

يُسمح فقط بالقيمة AD_ASSET_TYPE_IMAGE.

نص الاستجابة

رسالة ردّ لـ adAssets.upload

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "adAsset": {
    object (AdAsset)
  }
}
الحقول
adAsset

object (AdAsset)

تمثّل هذه السمة مادة عرض الإعلان التي تم إنشاؤها.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.