W przypadku każdego nowego elementu zamówienia musisz zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i interfejsu Display & Video 360 API, które nie zawierają deklaracji, zakończy się niepowodzeniem. Więcej informacji znajdziesz na naszej stronie dotyczącej wycofywania.
Wymagane. Identyfikator kanału nadrzędnego, do którego należą witryny.
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
{"deletedSites": [string],"createdSites": [{object (Site)}],// Union field owner can be only one of the following:"partnerId": string// End of list of possible types for union field owner.}
Pola
deletedSites[]
string
Witryny do usunięcia w ramach operacji zbiorczej, określone jako lista witryn url_or_app_ids.
Witryny do utworzenia w trybie wsadowym, określone 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-10 UTC."],[[["\u003cp\u003eThis operation allows for bulk editing of sites under a single channel, enabling deletion and creation of sites in batches.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes an HTTP POST request to a specific endpoint with required path parameters, including \u003ccode\u003echannelId\u003c/code\u003e and \u003ccode\u003eadvertiserId\u003c/code\u003e or \u003ccode\u003epartnerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body needs to specify the sites to be deleted and created, using their respective \u003ccode\u003eurl_or_app_ids\u003c/code\u003e or \u003ccode\u003eSite\u003c/code\u003e objects.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required via the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution returns a \u003ccode\u003eBulkEditSitesResponse\u003c/code\u003e object in the response body.\u003c/p\u003e\n"]]],["This outlines a bulk edit operation for sites within a channel, using a POST request to a specified URL. Key actions involve deleting sites listed in `deletedSites` and creating sites listed in `createdSites`. The request body is in JSON format and requires `channelId` and either `advertiserId` or `partnerId` as path parameters. Authorization requires the `https://www.googleapis.com/auth/display-video` scope. The successful response will include a `BulkEditSitesResponse`.\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\nBulk edits sites under a single channel.\n\nThe operation will delete the sites provided in [BulkEditSitesRequest.deleted_sites](/display-video/api/reference/rest/v3/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/v3/partners.channels.sites/bulkEdit#body.request_body.FIELDS.created_sites).\n\nHTTP request\n\n`POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit`\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 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| `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| ``` { \"deletedSites\": [ string ], \"createdSites\": [ { 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| `deletedSites[]` | `string` The sites to delete in batch, specified as a list of site [url_or_app_ids](/display-video/api/reference/rest/v3/advertisers.channels.sites#Site.FIELDS.url_or_app_id). |\n| `createdSites[]` | `object (`[Site](/display-video/api/reference/rest/v3/advertisers.channels.sites#Site)`)` The sites to create in batch, 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 [BulkEditSitesResponse](/display-video/api/reference/rest/v3/BulkEditSitesResponse).\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)."]]
