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 Overview。