A partir de
8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa
página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Method: customBiddingAlgorithms.rules.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria um novo recurso de regras. Retorna o recurso de regras recém-criado, se for bem-sucedido.
As solicitações que criam um recurso de regras de lances personalizados em um algoritmo atribuído a um item de linha vão retornar um erro.
Solicitação HTTP
POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
customBiddingAlgorithmId |
string (int64 format)
Obrigatório. O ID do algoritmo de lances personalizados que é proprietário do recurso de regras.
|
Parâmetros de consulta
| Parâmetros |
Parâmetro de união owner. Obrigatório. Identifica a entidade do DV360 que é proprietária do algoritmo de lances personalizados pai. Pode ser um parceiro ou um anunciante. owner pode ser apenas de um dos tipos a seguir: |
partnerId |
string (int64 format)
O ID do parceiro que é proprietário do algoritmo de lances personalizados principal. Somente esse parceiro terá acesso de gravação a esse recurso de regras.
|
advertiserId |
string (int64 format)
O ID do anunciante que é proprietário do algoritmo de lances personalizados principal.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de CustomBiddingAlgorithmRules.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de CustomBiddingAlgorithmRules.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/display-video
Para mais informações, consulte OAuth 2.0 Overview.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
