Method: partners.channels.sites.replace
Stay organized with collections
Save and categorize content based on your preferences.
Replaces all of the sites under a single channel.
The operation will replace the sites under a channel with the sites provided in ReplaceSitesRequest.new_sites
.
HTTP request
POST https://displayvideo.googleapis.com/v1beta2/partners/{partnerId}/channels/{channelId}/sites:replace
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
channelId |
string (int64 format)
Required. The ID of the parent channel whose sites will be replaced.
|
partnerId |
string (int64 format)
The ID of the partner that owns the parent channel.
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"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 .
} |
Fields |
newSites[] |
object (Site )
The sites that will replace the existing sites assigned to the channel, specified as a list of Sites .
|
Union field owner . Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. owner can be only one of the following: |
partnerId |
string (int64 format)
The ID of the partner that owns the parent channel.
|
advertiserId |
string (int64 format)
The ID of the advertiser that owns the parent channel.
|
Response body
If successful, the response body contains an instance of ReplaceSitesResponse
.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/display-video
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["Replaces all existing sites under a given channel with a new set of sites provided in the request."],["The operation requires specifying the partner and channel IDs in the request URL."],["The request body must contain a list of new sites and indicate whether the channel is owned by a partner or an advertiser."],["Successful execution results in a `ReplaceSitesResponse` object."],["Authorization necessitates the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This describes the `replace` operation for sites within a channel, using a `POST` HTTP request to the specified endpoint. The operation requires `partnerId` and `channelId` as path parameters. The request body should contain the new sites in `newSites` field, formatted as a JSON, that will replace the existing sites. It requires also the owner of the channel, that can be `advertiserId` or `partnerId`. The operation will return a `ReplaceSitesResponse` upon success and it needs the `https://www.googleapis.com/auth/display-video` authorization scope.\n"]]