À 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é.
Method: guaranteedOrders.editGuaranteedOrderReadAccessors
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Modifie les annonceurs lus d'une campagne garantie.
Requête HTTP
POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
guaranteedOrderId |
string
Obligatoire. ID de la commande garantie à modifier. L'ID est au format {exchange}-{legacyGuaranteedOrderId}.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"partnerId": string,
"readAccessInherited": boolean,
"addedAdvertisers": [
string
],
"removedAdvertisers": [
string
]
} |
| Champs |
partnerId |
string (int64 format)
Obligatoire. Contexte du partenaire dans lequel la modification est effectuée.
|
readAccessInherited |
boolean
Indique si tous les annonceurs du partenaire d'accès en lecture/écriture doivent disposer d'un accès en lecture à la campagne garantie. Ne s'applique que si readWritePartnerId est défini dans l'ordre garanti.
|
addedAdvertisers[] |
string (int64 format)
Annonceurs à ajouter en tant qu'accesseurs en lecture à la commande garantie.
|
removedAdvertisers[] |
string (int64 format)
Annonceurs à supprimer en tant qu'accesseurs en lecture de la commande garantie.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
| Représentation JSON |
{
"readAccessInherited": boolean,
"readAdvertiserIds": [
string
]
} |
| Champs |
readAccessInherited |
boolean
Indique si tous les annonceurs de readWritePartnerId ont un accès en lecture à la campagne garantie.
|
readAdvertiserIds[] |
string (int64 format)
ID des annonceurs disposant d'un accès en lecture à la commande garantie.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/display-video
Pour en savoir plus, consultez OAuth 2.0 Overview.
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)."],[],["The Display & Video 360 API v4 beta allows editing read accessors for a guaranteed order via a POST request to a specific URL, using the guaranteed order ID. The request body, in JSON format, must contain the partner ID, and may include whether read access is inherited, advertisers to be added, and advertisers to be removed as read accessors. The successful response body indicates whether access is inherited and lists IDs of advertisers with read access. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: guaranteedOrders.editGuaranteedOrderReadAccessors\n\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 - [JSON representation](#body.EditGuaranteedOrderReadAccessorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nEdits read advertisers of a guaranteed order.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrderId` | `string` Required. The ID of the guaranteed order to edit. The ID is of the format `{exchange}-{legacyGuaranteedOrderId}` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"partnerId\": string, \"readAccessInherited\": boolean, \"addedAdvertisers\": [ string ], \"removedAdvertisers\": [ string ] } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The partner context in which the change is being made. |\n| `readAccessInherited` | `boolean` Whether to give all advertisers of the read/write accessor partner read access to the guaranteed order. Only applicable if [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) is set in the guaranteed order. |\n| `addedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to add as read accessors to the guaranteed order. |\n| `removedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to remove as read accessors to the guaranteed order. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------|\n| ``` { \"readAccessInherited\": boolean, \"readAdvertiserIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `readAccessInherited` | `boolean` Whether all advertisers of [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) have read access to the guaranteed order. |\n| `readAdvertiserIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of advertisers with read access to the guaranteed order. |\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](/identity/protocols/OAuth2)."]]
