Method: advertisers.channels.sites.replace

取代單一管道下的所有網站。

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

這個方法經常發生高延遲問題。建議增加預設逾時時間，以免發生錯誤。

HTTP 要求

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

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

路徑參數

參數
channelId

string (int64 format)

必填。要取代網站的父項管道 ID。
必填。識別擁有上層頻道的 DV360 實體。擁有者可以是夥伴或廣告主。以下列出互斥欄位。回應中最多會設定一個欄位：
advertiserId

string (int64 format)

擁有上層頻道的廣告主 ID。
互斥欄位的結尾。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "newSites": [
    {
      object (Site)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string
  // End of mutually exclusive fields.
}
欄位
newSites[]

object (Site)

要取代指派給頻道的現有網站，以 Sites 清單形式指定。
必填。識別擁有上層頻道的 DV360 實體。擁有者可以是夥伴或廣告主。以下列出互斥欄位。回應中最多會設定一個欄位：
partnerId

string (int64 format)

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

string (int64 format)

擁有上層頻道的廣告主 ID。
互斥欄位的結尾。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。