1 つのチャンネル内のすべてのサイトを置き換えます。
このオペレーションにより、チャンネル内のサイトが ReplaceSitesRequest.new_sites で指定されたサイトに置き換えられます。
この方法では、通常、レイテンシが高くなります。エラーを回避するため、デフォルトのタイムアウトを長くすることをおすすめします。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels/{channelId}/sites:replace
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
| channelId | 
 必須。サイトが置き換えられる親チャネルの ID。 | 
| 結合パラメータ owner。必須。親チャンネルを所有するディスプレイ&ビデオ 360 エンティティを識別します。パートナーまたは広告主のいずれかです。ownerは次のいずれかになります。 | |
| advertiserId | 
 親チャネルを所有する広告主の ID。 | 
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 | 
|---|
| { "newSites": [ { object ( | 
| フィールド | |
|---|---|
| newSites[] | 
 チャンネルに割り当てられている既存のサイトに代わるサイト。 | 
| 共用体フィールド owner。必須。親チャンネルを所有するディスプレイ&ビデオ 360 エンティティを識別します。パートナーまたは広告主のいずれかです。ownerは次のいずれかになります。 | |
| partnerId | 
 親チャネルを所有するパートナーの ID。 | 
| advertiserId | 
 親チャネルを所有する広告主の ID。 | 
レスポンスの本文
成功した場合、レスポンスの本文には ReplaceSitesResponse のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
- https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 Overview をご覧ください。