Od 8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej stronie dotyczącej wycofania.
Wymagane. Identyfikator kanału nadrzędnego, którego witryny zostaną zastąpione.
Parametr zbiorczy owner. Wymagane. Identyfikuje podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
Identyfikator reklamodawcy, który jest właścicielem kanału nadrzędnego.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON
{"newSites": [{object (Site)}],// Union field owner can be only one of the following:"partnerId": string// End of list of possible types for union field owner.}
Witryny, które zastąpią dotychczasowe witryny przypisane do kanału, podane jako lista Sites.
Pole zbiorcze owner. Wymagane. Identyfikuje podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-09 UTC."],[[["\u003cp\u003eReplaces all existing sites under a given channel with a new list of sites.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the channel ID and the owner (either partner or advertiser ID).\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes a list of new sites to be assigned to the channel.\u003c/p\u003e\n"],["\u003cp\u003eThis operation may have high latency, so increasing timeout settings is recommended.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["| Display \\& Video 360 API v3 is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReplaces all of the sites under a single channel.\n\nThe operation will replace the sites under a channel with the sites provided in [ReplaceSitesRequest.new_sites](/display-video/api/reference/rest/v3/partners.channels.sites/replace#body.request_body.FIELDS.new_sites).\n\n**This method regularly experiences high latency.** We recommend [increasing your default timeout](/display-video/api/guides/best-practices/timeouts#client_library_timeout) to avoid errors.\n\nHTTP request\n\n`POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:replace`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent channel whose sites will be replaced. |\n| Union parameter `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: ||\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"newSites\": [ { object (/display-video/api/reference/rest/v3/advertisers.channels.sites#Site) } ], // Union field `owner` can be only one of the following: \"partnerId\": string // End of list of possible types for union field `owner`. } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `newSites[]` | `object (`[Site](/display-video/api/reference/rest/v3/advertisers.channels.sites#Site)`)` The sites that will replace the existing sites assigned to the channel, specified as a list of [Sites](/display-video/api/reference/rest/v3/advertisers.channels.sites#Site). |\n| 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: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent channel. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\n\nResponse body\n\nIf successful, the response body contains an instance of [ReplaceSitesResponse](/display-video/api/reference/rest/v3/ReplaceSitesResponse).\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
