Method: advertisers.channels.sites.replace

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

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

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

درخواست HTTP

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

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

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

پارامترها
channel Id

string ( int64 format)

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

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

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.
}
فیلدها
new Sites[]

object ( Site )

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

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

string ( int64 format)

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

advertiser Id

string ( int64 format)

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

بدن پاسخگو

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

محدوده مجوز

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

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

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