Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
Method: guaranteedOrders.editGuaranteedOrderReadAccessors
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Edytuje odczyt reklamodawców w zamówieniu gwarantowanym.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
guaranteedOrderId |
string
Wymagane. Identyfikator zamówienia gwarantowanego, które chcesz edytować. Identyfikator ma format {exchange}-{legacyGuaranteedOrderId}
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"partnerId": string,
"readAccessInherited": boolean,
"addedAdvertisers": [
string
],
"removedAdvertisers": [
string
]
} |
| Pola |
partnerId |
string (int64 format)
Wymagane. Kontekst partnera, w którym wprowadzana jest zmiana.
|
readAccessInherited |
boolean
Określa, czy wszyscy reklamodawcy partnera z dostępem typu „Odczyt/zapis” mają mieć dostęp tylko do odczytu w ramach zamówienia gwarantowanego. Dotyczy tylko sytuacji, gdy w zamówieniu gwarantowanym ustawiona jest wartość readWritePartnerId.
|
addedAdvertisers[] |
string (int64 format)
Reklamodawcy, których chcesz dodać jako użytkowników z dostępem tylko do odczytu do zamówienia gwarantowanego.
|
removedAdvertisers[] |
string (int64 format)
Reklamodawcy, których chcesz usunąć jako użytkowników z dostępem tylko do odczytu do zamówienia gwarantowanego.
|
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"readAccessInherited": boolean,
"readAdvertiserIds": [
string
]
} |
| Pola |
readAccessInherited |
boolean
Określ, czy wszyscy reklamodawcy w readWritePartnerId mają dostęp w trybie odczytu do zamówienia gwarantowanego.
|
readAdvertiserIds[] |
string (int64 format)
Identyfikatory reklamodawców z dostępem tylko do odczytu do zamówienia gwarantowanego.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w OAuth 2.0 Overview.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
