С
8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см.
на странице «Устаревшие функции».
Method: guaranteedOrders.editGuaranteedOrderReadAccessors
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Правки читают рекламодатели гарантированного заказа.
HTTP-запрос
POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
guaranteedOrderId | string Необходимый. Идентификатор гарантированного заказа для редактирования. Идентификатор имеет формат {exchange}-{legacyGuaranteedOrderId} |
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"partnerId": string,
"readAccessInherited": boolean,
"addedAdvertisers": [
string
],
"removedAdvertisers": [
string
]
} |
| Поля |
|---|
partnerId | string ( int64 format) Необходимый. Контекст партнера, в котором вносятся изменения. |
readAccessInherited | boolean Предоставлять ли всем рекламодателям партнера по средствам доступа для чтения и записи доступ на чтение к гарантированному заказу. Применимо только в том случае, если readWritePartnerId установлен в гарантированном порядке. |
addedAdvertisers[] | string ( int64 format) Рекламодатели должны добавлять средства доступа для чтения к гарантированному заказу. |
removedAdvertisers[] | string ( int64 format) Рекламодателей следует удалить как средства доступа к гарантированному заказу. |
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"readAccessInherited": boolean,
"readAdvertiserIds": [
string
]
} |
| Поля |
|---|
readAccessInherited | boolean Имеют ли все рекламодатели readWritePartnerId доступ на чтение гарантированного заказа. |
readAdvertiserIds[] | string ( int64 format) Идентификаторы рекламодателей с доступом на чтение гарантированного заказа. |
Области авторизации
Требуется следующая область действия 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 beta allows editing read accessors for a guaranteed order via a POST request to a specific URL, using the guaranteed order ID. The request body, in JSON format, must contain the partner ID, and may include whether read access is inherited, advertisers to be added, and advertisers to be removed as read accessors. The successful response body indicates whether access is inherited and lists IDs of advertisers with read access. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: guaranteedOrders.editGuaranteedOrderReadAccessors\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.EditGuaranteedOrderReadAccessorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nEdits read advertisers of a guaranteed order.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrderId` | `string` Required. The ID of the guaranteed order to edit. The ID is of the format `{exchange}-{legacyGuaranteedOrderId}` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"partnerId\": string, \"readAccessInherited\": boolean, \"addedAdvertisers\": [ string ], \"removedAdvertisers\": [ string ] } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The partner context in which the change is being made. |\n| `readAccessInherited` | `boolean` Whether to give all advertisers of the read/write accessor partner read access to the guaranteed order. Only applicable if [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) is set in the guaranteed order. |\n| `addedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to add as read accessors to the guaranteed order. |\n| `removedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to remove as read accessors to the guaranteed order. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------|\n| ``` { \"readAccessInherited\": boolean, \"readAdvertiserIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `readAccessInherited` | `boolean` Whether all advertisers of [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) have read access to the guaranteed order. |\n| `readAdvertiserIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of advertisers with read access to the guaranteed order. |\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)."]]
