A partir del
8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra
página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Method: customBiddingAlgorithms.rules.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea un nuevo recurso de reglas. Devuelve el recurso de reglas recién creado si se realiza correctamente.
Las solicitudes que creen un recurso de reglas de ofertas personalizadas con un algoritmo asignado a una línea de pedido mostrarán un error.
Solicitud HTTP
POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
customBiddingAlgorithmId |
string (int64 format)
Obligatorio. Es el ID del algoritmo de ofertas personalizadas al que pertenece el recurso de reglas.
|
Parámetros de consulta
| Parámetros |
Parámetro de unión owner. Obligatorio. Identifica la entidad de DV360 a la que pertenece el algoritmo de ofertas personalizadas superior. Puede ser un socio o un anunciante. Las direcciones (owner) solo pueden ser una de las siguientes opciones: |
partnerId |
string (int64 format)
Es el ID del socio propietario del algoritmo de ofertas personalizadas superior. Solo este socio tendrá acceso de escritura a este recurso de reglas.
|
advertiserId |
string (int64 format)
Es el ID del anunciante que es propietario del algoritmo de ofertas personalizadas superior.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de CustomBiddingAlgorithmRules.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de CustomBiddingAlgorithmRules.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta OAuth 2.0 Overview.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
