列出目前使用者可存取的保證訂單。
順序由 orderBy
參數定義。如未指定 entityStatus
的 filter
,結果中不會包含實體狀態為 ENTITY_STATUS_ARCHIVED
的保證訂單。
HTTP 要求
GET https://displayvideo.googleapis.com/v1/guaranteedOrders
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
pageSize |
要求的頁面大小。必須介於 |
pageToken |
識別伺服器應傳回之結果頁面的符記。通常這是先前呼叫 |
orderBy |
清單排序依據的欄位。可接受的值為:
預設的排序順序是遞增。如要為欄位指定遞減順序,請在欄位名稱中加入後置字串「desc」。例如 |
filter |
允許按保證訂單欄位進行篩選。
支援的欄位:* 示例:
這個欄位的長度不得超過 500 個字元。 詳情請參閱篩選器 |
聯集參數 指出要求的來源 DV360 實體。清單要求只會傳回可在「 |
|
partnerId |
可存取保證訂單的合作夥伴 ID。 |
advertiserId |
可存取保證訂單的廣告客戶 ID。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"guaranteedOrders": [
{
object ( |
欄位 | |
---|---|
guaranteedOrders[] |
保證訂單清單。 如果留空,這份清單將不會顯示。 |
nextPageToken |
用於擷取下一頁結果的權杖。在對 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽。