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, do którego należą witryny.
Parametr sumy owner. Wymagane. Identyfikuje jednostkę DV360, do której należy kanał nadrzędny. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
Identyfikator partnera, który jest właścicielem kanału nadrzędnego.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON
{"deletedSites": [string],"createdSites": [{object (Site)}],// Union field owner can be only one of the following:"advertiserId": string// End of list of possible types for union field owner.}
Pola
deletedSites[]
string
Witryny do usunięcia zbiorczo, określone jako lista witryn url_or_app_ids.
Witryny do utworzenia zbiorczo, określone w postaci listy Sites.
Pole sumy owner. Wymagane. Identyfikuje jednostkę DV360, do której należy kanał nadrzędny. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eBulk edits sites under a single channel, allowing for batch deletion and creation.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v2/partners/{partnerId}/channels/{channelId}/sites:bulkEdit\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the \u003ccode\u003echannelId\u003c/code\u003e and the owner (\u003ccode\u003epartnerId\u003c/code\u003e or \u003ccode\u003eadvertiserId\u003c/code\u003e) in the path parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes lists of sites to delete (\u003ccode\u003edeletedSites\u003c/code\u003e) and create (\u003ccode\u003ecreatedSites\u003c/code\u003e), along with the parent channel owner.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content describes the process for bulk editing sites within a channel using the Display & Video 360 API. The `POST` request to the specified URL requires a `channelId` and the `partnerId`. The request body must include `deletedSites` (a list of URLs or app IDs to delete) and `createdSites` (a list of `Site` objects to create). Successful operations will return a `BulkEditSitesResponse`. This function also requires specific OAuth scope for authorization.\n"],null,["# Method: partners.channels.sites.bulkEdit\n\n| Display \\& Video 360 API v2 has sunset.\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\nBulk edits sites under a single channel.\n\nThe operation will delete the sites provided in [BulkEditSitesRequest.deleted_sites](/display-video/api/reference/rest/v2/partners.channels.sites/bulkEdit#body.request_body.FIELDS.deleted_sites) and then create the sites provided in [BulkEditSitesRequest.created_sites](/display-video/api/reference/rest/v2/partners.channels.sites/bulkEdit#body.request_body.FIELDS.created_sites).\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v2/partners/{partnerId}/channels/{channelId}/sites:bulkEdit`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path 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 to which the sites belong. |\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| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent channel. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deletedSites\": [ string ], \"createdSites\": [ { object (/display-video/api/reference/rest/v2/advertisers.channels.sites#Site) } ], // Union field `owner` can be only one of the following: \"advertiserId\": string // End of list of possible types for union field `owner`. } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deletedSites[]` | `string` The sites to delete in batch, specified as a list of site [url_or_app_ids](/display-video/api/reference/rest/v2/advertisers.channels.sites#Site.FIELDS.url_or_app_id). |\n| `createdSites[]` | `object (`[Site](/display-video/api/reference/rest/v2/advertisers.channels.sites#Site)`)` The sites to create in batch, specified as a list of [Sites](/display-video/api/reference/rest/v2/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\n### Response body\n\nIf successful, the response body contains an instance of [BulkEditSitesResponse](/display-video/api/reference/rest/v2/BulkEditSitesResponse).\n\n### Authorization 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](https://developers.google.com/identity/protocols/OAuth2)."]]
