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)

必須。サイトが置き換えられる親チャネルの ID。
必須。親チャネルを所有するディスプレイ＆ビデオ 360 エンティティを識別します。パートナーまたは広告主様のいずれかになります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 のリストとして指定します。
必須。親チャネルを所有するディスプレイ＆ビデオ 360 エンティティを識別します。パートナーまたは広告主様のいずれかになります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
partnerId

string (int64 format)

親チャネルを所有するパートナーの ID。
advertiserId

string (int64 format)

親チャネルを所有する広告主の ID。
相互に排他的なフィールドの終わり。

レスポンスの本文

成功した場合、レスポンスの本文には ReplaceSitesResponse のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。