Method: partners.channels.sites.replace

1 つのチャネルのすべてのサイトを置き換えます。

このオペレーションにより、チャンネル内のサイトが ReplaceSitesRequest.new_sites で指定されたサイトに置き換えられます。

この方法では、通常、レイテンシが高くなります。エラーを回避するため、デフォルトのタイムアウトを長くすることをおすすめします。

HTTP リクエスト

POST https://displayvideo.googleapis.com/v3/partners/{partnerId}/channels/{channelId}/sites:replace

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
channelId

string (int64 format)

必須。サイトが置き換えられる親チャネルの ID。
共用体パラメータ owner。必須。親チャンネルを所有するディスプレイ＆ビデオ 360 エンティティを識別します。パートナーまたは広告主のいずれかです。owner は次のいずれかになります。
partnerId

string (int64 format)

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

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

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

  // Union field owner can be only one of the following:
  "advertiserId": string
  // End of list of possible types for union field owner.
}
フィールド
newSites[]

object (Site)

チャンネルに割り当てられている既存のサイトに代わるサイト。Sites のリストとして指定します。
共用体フィールド owner。必須。親チャンネルを所有するディスプレイ＆ビデオ 360 エンティティを識別します。パートナーまたは広告主のいずれかになります。owner は次のいずれかになります。
partnerId

string (int64 format)

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

string (int64 format)

親チャンネルを所有する広告主の ID。

レスポンスの本文

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

認可スコープ

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

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

詳しくは、OAuth 2.0 の概要をご覧ください。