انبوه سایت ها را تحت یک کانال ویرایش می کند.
این عملیات سایت های ارائه شده در BulkEditSitesRequest.deleted_sites
حذف می کند و سپس سایت های ارائه شده در BulkEditSitesRequest.created_sites
ایجاد می کند.
درخواست HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
channel Id | مورد نیاز. شناسه کانال اصلی که سایت ها به آن تعلق دارند. |
owner پارامتر اتحادیه مورد نیاز. موجودیت DV360 را که مالک کانال اصلی است شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. owner تنها می تواند یکی از موارد زیر باشد: | |
advertiser Id | شناسه تبلیغکنندهای که مالک کانال اصلی است. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "deletedSites": [ string ], "createdSites": [ { object ( |
فیلدها | |
---|---|
deleted Sites[] | سایت هایی که باید به صورت دسته ای حذف شوند، به عنوان لیستی از سایت |
created Sites[] | سایت هایی که باید به صورت دسته ای ایجاد شوند، به عنوان لیستی از |
owner میدان اتحادیه مورد نیاز. موجودیت DV360 را که مالک کانال اصلی است شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. owner تنها می تواند یکی از موارد زیر باشد: | |
partner Id | شناسه شریک مالک کانال اصلی. |
advertiser Id | شناسه تبلیغکنندهای که مالک کانال اصلی است. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از BulkEditSitesResponse
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.