Method: advertisers.adAssets.upload

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

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

لا يمكن تحميل سوى مواد العرض التي تحمل AdAssetType AD_ASSET_TYPE_IMAGE.

طلب HTTP

  • عنوان URI للتحميل، لطلبات تحميل الوسائط:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • عنوان URI للبيانات الوصفية، للطلبات التي تتضمّن بيانات وصفية فقط:
    POST https://displayvideo.googleapis.com/v4/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.