2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合（EU）の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ＆ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
Method: guaranteedOrders.patch
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
既存の保証付き注文を更新します。成功した場合は、更新された保証付き注文を返します。
HTTP リクエスト
PATCH https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
guaranteedOrder.guaranteedOrderId |
string
出力専用。保証付き注文の一意の識別子。保証付きオーダー ID の形式は {exchange}-{legacyGuaranteedOrderId} です。
|
クエリ パラメータ
| パラメータ |
updateMask |
string (FieldMask format)
必須。どのフィールドを更新するかを制御するマスク。 完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
|
結合パラメータ accessor。必須。 リクエストがどの DV360 エンティティ内で行われたかを識別します。accessor は次のいずれかになります。 |
partnerId |
string (int64 format)
リクエストが送信されているパートナーの ID。
|
advertiserId |
string (int64 format)
リクエストが送信されている広告主の ID。
|
リクエストの本文
リクエストの本文には GuaranteedOrder のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には GuaranteedOrder のインスタンスが含まれます。
認可スコープ
次の 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。"],[[["\u003cp\u003eUpdates an existing guaranteed order and returns the updated order upon success.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the guaranteed order ID in the path parameters.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes a \u003ccode\u003eupdateMask\u003c/code\u003e in query parameters to control which fields are updated and requires specifying either \u003ccode\u003epartnerId\u003c/code\u003e or \u003ccode\u003eadvertiserId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eGuaranteedOrder\u003c/code\u003e object, and a successful response will return the updated \u003ccode\u003eGuaranteedOrder\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: guaranteedOrders.patch\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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\nUpdates an existing guaranteed order. Returns the updated guaranteed order if successful.\n\n### HTTP request\n\n`PATCH https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrder.guaranteedOrderId` | `string` Output only. The unique identifier of the guaranteed order. The guaranteed order IDs have the format `{exchange}-{legacyGuaranteedOrderId}`. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The mask to control which fields to update. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\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/v3/guaranteedOrders#GuaranteedOrder).\n\n### Response body\n\nIf successful, the response body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v3/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)."]]
