С
8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см.
на странице «Устаревшие функции».
Method: customBiddingAlgorithms.rules.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает новый ресурс правил. В случае успеха возвращает вновь созданный ресурс правил.
Запросы на создание ресурса специальных правил назначения ставок в соответствии с алгоритмом, назначенным позиции, возвращают ошибку.
HTTP-запрос
POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
customBiddingAlgorithmId | string ( int64 format) Необходимый. Идентификатор специального алгоритма назначения ставок, которому принадлежит ресурс правил. |
Параметры запроса
| Параметры |
|---|
owner параметра объединения. Необходимый. Идентифицирует объект DV360, которому принадлежит родительский алгоритм специального назначения ставок. Это может быть как партнер, так и рекламодатель. owner может быть только один из следующих: |
partnerId | string ( int64 format) Идентификатор партнера, которому принадлежит родительский алгоритм специального назначения ставок. Только этот партнер будет иметь доступ для записи к этому ресурсу правил. |
advertiserId | string ( int64 format) Идентификатор рекламодателя, которому принадлежит родительский алгоритм специального назначения ставок. |
Тело запроса
Тело запроса содержит экземпляр CustomBiddingAlgorithmRules .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр CustomBiddingAlgorithmRules .
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/display-video
Для получения дополнительной информации см.OAuth 2.0 Overview .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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)."]]
