Method: advertisers.channels.sites.replace

替換單一管道下的所有網站。

這項作業會將頻道下的網站替換為 ReplaceSitesRequest.new_sites 中提供的網站。

此方法經常會發生高延遲情況。建議您增加預設逾時時間，以免發生錯誤。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
channelId

string (int64 format)

必要欄位。要取代網站的父項管道 ID。
聯集參數 owner。必要欄位。識別擁有父項管道的 DV360 實體。可以是夥伴或廣告客戶。owner 只能是下列其中一項：
advertiserId

string (int64 format)

擁有父項頻道的廣告主 ID。

要求主體

要求主體的資料會採用以下結構：

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)

擁有父項頻道的合作夥伴 ID。
advertiserId

string (int64 format)

擁有父項頻道的廣告主 ID。

回應主體

如果成功，回應主體會包含 ReplaceSitesResponse 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。