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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
advertiserId

string (int64 format)

الزامی. شناسه تبلیغ‌کننده‌ای که این دارایی آگهی به آن تعلق دارد.

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "filename": string,
  "adAssetType": enum (AdAssetType),
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
فیلدها
filename

string

الزامی. نام فایل دارایی آگهی، ازجمله پسوند فایل.

نام فایل باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۴۰ بایت باشد.
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 مراجعه کنید.