Method: advertisers.channels.sites.replace

همه سایت ها را تحت یک کانال جایگزین می کند.

این عملیات سایت های تحت یک کانال را با سایت های ارائه شده در ReplaceSitesRequest.new_sites جایگزین می کند.

این روش به طور منظم تاخیر بالایی را تجربه می کند. توصیه می کنیم برای جلوگیری از بروز خطا ، مهلت زمانی پیش فرض خود را افزایش دهید .

درخواست HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels/{channelId}/sites:replace

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

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

پارامترها
channelId

string ( int64 format)

مورد نیاز. شناسه کانال اصلی که سایت های آن جایگزین می شود.

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

string ( int64 format)

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

درخواست بدن

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

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

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

object ( Site )

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

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

string ( int64 format)

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

advertiserId

string ( int64 format)

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

بدن پاسخگو

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

محدوده مجوز

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

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

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