À partir du 8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre page sur les abandons de compatibilité.
Obligatoire. Identifiant du canal parent auquel appartiennent les sites.
Paramètre d'union owner. Obligatoire. Identifie l'entité DV360 qui possède la chaîne parente. Il peut s'agir d'un partenaire ou d'un annonceur. owner ne peut être qu'un des éléments suivants :
Référence de l'annonceur qui possède le canal parent.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation 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.}
Champs
deletedSites[]
string
Sites à supprimer de façon groupée, spécifiés sous la forme d'une liste de sites url_or_app_ids.
Sites à créer de façon groupée, spécifiés sous la forme d'une liste de Sites.
Champ d'union owner. Obligatoire. Identifie l'entité DV360 qui possède la chaîne parente. Il peut s'agir d'un partenaire ou d'un annonceur. owner ne peut être qu'un des éléments suivants :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThis document details the \u003ccode\u003ebulkEdit\u003c/code\u003e method for sites under a single channel in Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eThe operation allows for batch deletion and creation of sites using the \u003ccode\u003edeletedSites\u003c/code\u003e and \u003ccode\u003ecreatedSites\u003c/code\u003e fields respectively.\u003c/p\u003e\n"],["\u003cp\u003eIt requires specifying the parent channel's ID and the owner (either advertiser or partner) in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body needs to include a JSON structure with the sites to delete and create.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution returns a \u003ccode\u003eBulkEditSitesResponse\u003c/code\u003e object.\u003c/p\u003e\n"]]],["This document details the bulk editing of sites within a channel using the Display & Video 360 API. This is done via a `POST` request to a specified URL, which requires `channelId` and either `advertiserId` or `partnerId`. The request body defines `deletedSites`, a list of URLs or app IDs for deletion, and `createdSites`, a list of sites for creation. The operation removes listed sites and then creates the new ones. Authorization is needed with the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: advertisers.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/advertisers/{advertiserId}/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| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser 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: \"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/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)."]]