С
8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см.
на странице «Устаревшие функции».
Method: guaranteedOrders.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает новый гарантированный заказ. В случае успеха возвращает вновь созданный гарантированный заказ.
HTTP-запрос
POST https://displayvideo.googleapis.com/v4/guaranteedOrders
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
| Параметры |
|---|
accessor параметру объединения. Необходимый. Определяет, в рамках какого объекта DV360 делается запрос. accessor может быть только одним из следующих: |
partnerId | string ( int64 format) Идентификатор партнера, от которого делается запрос. |
advertiserId | string ( int64 format) Идентификатор рекламодателя, от которого делается запрос. |
Тело запроса
Тело запроса содержит экземпляр GuaranteedOrder .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр GuaranteedOrder .
Области авторизации
Требуется следующая область действия 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, in beta, allows creating a new guaranteed order via a `POST` request to `https://displayvideo.googleapis.com/v4/guaranteedOrders`. The request requires a specified `accessor` parameter, either `partnerId` or `advertiserId`. The request body should contain a `GuaranteedOrder` instance. Upon success, the API returns the newly created `GuaranteedOrder` in the response body, and requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: guaranteedOrders.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\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 guaranteed order. Returns the newly created guaranteed order if successful.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/guaranteedOrders`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. `accessor` 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 the request is being made within. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that the request is being made within. |\n\n### Request body\n\nThe request body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\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)."]]
