Method: advertisers.sdfuploadtasks.upload

یک وظیفه آپلود SDF ایجاد می کند. یک Operation را برمی‌گرداند.

یک وظیفه آپلود SDF یک عملیات ناهمزمان و طولانی مدت است. نوع metadata این عملیات SdfUploadTaskMetadata است. اگر درخواست موفقیت آمیز باشد، نوع response عملیات SdfUploadTask است. پاسخ شامل فایل‌های به‌دست‌آمده نمی‌شود، که می‌توان آن‌ها را با استفاده از media.download بازیابی کرد.

وضعیت عملکرد را می توان با sdfuploadtask.operations.get بازیابی کرد.

هر گونه خطا را می توان در error.message یافت. توجه داشته باشید که error.details انتظار می رود خالی باشد.

درخواست HTTP

  • URI آپلود، برای درخواست های آپلود رسانه:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI فراداده، برای درخواست‌های فقط فراداده:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
advertiserId

string ( int64 format)

مورد نیاز. شناسه تبلیغ‌کننده برای آپلود SDF.

درخواست بدن

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

نمایندگی JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
فیلدها
filename

string

مورد نیاز. نام فایل دارایی، از جمله پسوند فایل. نام فایل باید UTF-8 با حداکثر اندازه 240 بایت رمزگذاری شده باشد.

sdfVersion

enum ( SdfVersion )

مورد نیاز. نسخه SDF فایل آپلود شده. اگر روی SDF_VERSION_UNSPECIFIED تنظیم شود، این نسخه به طور پیش‌فرض به نسخه مشخص‌شده توسط تبلیغ‌کننده شناسایی‌شده خواهد بود. تبلیغ‌کننده نسخه SDF خود را از شریک خود به ارث می‌برد، مگر اینکه پیکربندی دیگری داشته باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .