À 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: customBiddingAlgorithms.rules.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée une ressource de règles. Si la requête aboutit, elle affiche la ressource de règles créée.
Les requêtes qui créent une ressource de règles d'enchères personnalisées sous un algorithme attribué à un élément de campagne renvoient une erreur.
Requête HTTP
POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
customBiddingAlgorithmId |
string (int64 format)
Obligatoire. ID de l'algorithme d'enchères personnalisées propriétaire de la ressource de règles.
|
Paramètres de requête
| Paramètres |
Paramètre d'union owner. Obligatoire. Identifie l'entité DV360 propriétaire de l'algorithme d'enchères personnalisées parent. Il peut s'agir d'un partenaire ou d'un annonceur. owner ne peut être qu'un des éléments suivants : |
partnerId |
string (int64 format)
ID du partenaire propriétaire de l'algorithme d'enchères personnalisées parent. Seul ce partenaire aura accès en écriture à cette ressource de règles.
|
advertiserId |
string (int64 format)
ID de l'annonceur propriétaire de l'algorithme d'enchères personnalisées parent.
|
Corps de la requête
Le corps de la requête contient une instance de CustomBiddingAlgorithmRules.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de CustomBiddingAlgorithmRules.
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, currently in beta, allows creating new rules resources via a `POST` request to a specified URL. This requires the `customBiddingAlgorithmId` as a path parameter, as well as an `owner` query parameter to define the DV360 entity (partner or advertiser) owning the algorithm. The request body must contain an instance of `CustomBiddingAlgorithmRules`, and a successful request returns the newly created rule instance in the response body. Note that starting April 1, 2025, requests to update custom bidding algorithms assigned to line items will return an error.\n"],null,["# Method: customBiddingAlgorithms.rules.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new rules resource. Returns the newly created rules resource if successful.\n\nRequests creating a custom bidding rules resource under an algorithm assigned to a line item will return an error.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customBiddingAlgorithmId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the custom bidding algorithm that owns the rules resource. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. 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 custom bidding algorithm. Only this partner will have write access to this rules resource. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent custom bidding algorithm. |\n\n### Request body\n\nThe request body contains an instance of [CustomBiddingAlgorithmRules](/display-video/api/reference/rest/v4/customBiddingAlgorithms.rules#CustomBiddingAlgorithmRules).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CustomBiddingAlgorithmRules](/display-video/api/reference/rest/v4/customBiddingAlgorithms.rules#CustomBiddingAlgorithmRules).\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)."]]
