Method: advertisers.channels.sites.bulkEdit

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

این عملیات سایت های ارائه شده در BulkEditSitesRequest.deleted_sites را حذف می کند و سپس سایت های ارائه شده در BulkEditSitesRequest.created_sites را ایجاد می کند.

درخواست HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit

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

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

پارامترها
channelId

string ( int64 format)

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

owner پارامتر اتحادیه مورد نیاز. موجودیت DV360 را که مالک کانال اصلی است شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. owner تنها می تواند یکی از موارد زیر باشد:
advertiserId

string ( int64 format)

شناسه تبلیغ‌کننده‌ای که مالک کانال اصلی است.

درخواست بدن

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

نمایندگی JSON
{
  "deletedSites": [
    string
  ],
  "createdSites": [
    {
      object (Site)
    }
  ],

  // Union field owner can be only one of the following:
  "partnerId": string
  // End of list of possible types for union field owner.
}
فیلدها
deletedSites[]

string

سایت هایی که باید به صورت دسته ای حذف شوند، به عنوان لیستی از سایت url_or_app_ids مشخص شده اند.

createdSites[]

object ( Site )

سایت هایی که باید به صورت دسته ای ایجاد شوند، به عنوان لیستی از Sites مشخص شده اند.

owner میدان اتحادیه مورد نیاز. موجودیت DV360 را که مالک کانال اصلی است شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. owner تنها می تواند یکی از موارد زیر باشد:
partnerId

string ( int64 format)

شناسه شریک مالک کانال اصلی.

advertiserId

string ( int64 format)

شناسه تبلیغ‌کننده‌ای که مالک کانال اصلی است.

بدن پاسخگو

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

محدوده مجوز

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

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

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