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