Method: advertisers.assets.upload

دارایی را بارگذاری می‌کند. درصورت موفقیت‌آمیز بودن، شناسه دارایی تازه بارگذاری‌شده را برمی‌گرداند. اندازه فایل دارایی نباید بیشتر از ۱۰ مگابایت برای تصاویر، ۲۰۰ مگابایت برای فایل‌های ZIP، و ۱ گیگابایت برای ویدیوها باشد.

باید در فرایند بارگذاری رسانه چندبخشی استفاده شود. نمونه‌هایی که از کتابخانه‌های مشتری ارائه‌شده استفاده می‌کنند را می‌توانید در راهنمای ایجاد طرح‌های آگهی ما پیدا کنید.

درخواست HTTP

  • ‫URI بارگذاری، برای درخواست‌های بارگذاری رسانه:
    POST https://displayvideo.googleapis.com/upload/v5/advertisers/{advertiserId}/assets

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

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

پارامترها
advertiserId

string (int64 format)

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

متن درخواست

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

نمایش JSON 
{
  "filename": string
}
فیلدها
filename

string

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

نام فایل باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۴۰ بایت باشد.

بدنه پاسخ

پیام پاسخ برای assets.upload.

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "asset": {
    object (Asset)
  }
}
فیلدها
asset

object (Asset)

دارایی بارگذاری‌شده، درصورت موفقیت‌آمیز بودن.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به OAuth 2.0 Overview مراجعه کنید.