2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
Method: guaranteedOrders.editGuaranteedOrderReadAccessors
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
guaranteedOrderId |
string
必須。編集する保証付きオーダーの ID。 ID の形式は {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)
保証オーダーに対する読み取り権限を持つ広告主の ID。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。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)."]]