1 つのチャネルのすべてのサイトを置き換えます。
このオペレーションにより、チャネル内のサイトが ReplaceSitesRequest.new_sites
で指定されたサイトに置き換えられます。
この方法では、定期的に高いレイテンシが発生します。エラーを回避するために、デフォルトのタイムアウトを増やすことをおすすめします。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v3/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 の概要をご覧ください。