Method: guaranteedOrders.get
HTTP 要求
GET https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrderId}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
guaranteedOrderId |
string
必要欄位。要擷取的保證訂單 ID。 ID 的格式為 {exchange}-{legacyGuaranteedOrderId}
|
查詢參數
| 參數 |
聯集參數 accessor。必填。 指出要求是在哪個 DV360 實體中提出。GET 要求只會傳回保證訂單，且該訂單必須可供 accessor 中識別的 DV360 實體存取。accessor 只能是下列其中一項： |
partnerId |
string (int64 format)
有權存取保證訂單的合作夥伴 ID。
|
advertiserId |
string (int64 format)
具備保證訂單存取權的廣告主 ID。
|
回應主體
如果成功，回應主體會包含 GuaranteedOrder 的執行例項。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-02-25 (世界標準時間)。
[null,null,["上次更新時間：2025-02-25 (世界標準時間)。"],[[["Retrieves a specific guaranteed order using its unique identifier, formatted as `{exchange}-{legacyGuaranteedOrderId}`."],["Requires specifying an `accessor` in the query parameters to identify the DV360 entity (partner or advertiser) with access to the order."],["The request body should be empty, and a successful response returns a `GuaranteedOrder` object."],["Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details how to retrieve a guaranteed order using a GET request. The request URL structure includes `guaranteedOrderId` as a required path parameter, formatted as `{exchange}-{legacyGuaranteedOrderId}`. A required query parameter, `accessor`, specifies either a `partnerId` or `advertiserId` to define the DV360 entity. The request body must be empty. Upon success, the response body contains a `GuaranteedOrder` instance. Access requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"]]
