Method: advertisers.adAssets.upload

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

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

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

طلب HTTP

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

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

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

المعلمات
advertiserId

string (int64 format)

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

نص الطلب

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

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

string

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

يجب أن يكون اسم الملف بترميز UTF-8 وألا يزيد حجمه عن 240 بايت.
adAssetType

enum (AdAssetType)

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

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

enum (SyntheticContentAttestationStatus)

اختيارية: ما إذا كنت تريد إضافة تصنيف إلى مادة العرض على أنّها مُنشأة أو مُعدّلة باستخدام الذكاء الاصطناعي عند عرضها في مناطق تتضمّن لوائح تنظيمية محلية بشأن تصنيف استخدام الذكاء الاصطناعي

نص الاستجابة

رسالة ردّ على adAssets.upload

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

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

object (AdAsset)

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

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

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

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

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