Method: advertisers.insertionOrders.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
advertiserId |
string (int64 format)
必要欄位。要列出其廣告訂單的廣告主 ID。
|
查詢參數
參數 |
pageSize |
integer
要求的頁面大小。必須介於 1 至 100 之間。如果未指定,則預設值為 100 。如果指定的值無效,則傳回錯誤代碼 INVALID_ARGUMENT 。
|
pageToken |
string
用於識別伺服器應傳回之結果頁面的符記。一般而言,這是從先前呼叫 insertionOrders.list 方法傳回的 nextPageToken 值。如果未指定,系統將傳回第一頁的結果。
|
orderBy |
string
清單排序依據的欄位。可接受的值為:
- "displayName"(預設)
- 「entityStatus」
- 「updateTime」
預設的排序順序是遞增。如要為欄位指定遞減順序,請在後方加上「desc」即可加入欄位名稱。範例:displayName desc 。
|
filter |
string
可按照廣告訂單欄位篩選資料。 支援的語法:
- 篩選器運算式由一或多個限制組成。
- 限制可用
AND 或 OR 邏輯運算子合併。一組限制會隱含使用 AND 。
- 限制的形式為
{field} {operator} {value} 。
updateTime 欄位必須使用 GREATER THAN OR EQUAL TO (>=) 或 LESS THAN OR EQUAL TO (<=) 運算子。
- 所有其他欄位都必須使用
EQUALS (=) 運算子。
支援的欄位:
campaignId
displayName
entityStatus
updateTime (採用 ISO 8601 格式,或 YYYY-MM-DDTHH:MM:SSZ )
範例:
- 廣告活動中的所有廣告訂單:
campaignId="1234"
- 廣告主的所有
ENTITY_STATUS_ACTIVE 或 ENTITY_STATUS_PAUSED 個廣告訂單:(entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
- 所有更新時間小於或等於 2020-11-04T18:54:47Z 的廣告訂單 (格式為 ISO 8601):
updateTime<="2020-11-04T18:54:47Z"
- 所有更新時間大於或等於 2020-11-04T18:54:47Z 的廣告訂單 (格式為 ISO 8601):
updateTime>="2020-11-04T18:54:47Z"
這個欄位的長度不得超過 500 個半形字元。 詳情請參閱篩選器 LIST 要求指南。
|
回應主體
JSON 表示法 |
{
"insertionOrders": [
{
object (InsertionOrder )
}
],
"nextPageToken": string
} |
欄位 |
insertionOrders[] |
object (InsertionOrder )
廣告訂單清單。 如果留空,這份清單就不會顯示。
|
nextPageToken |
string
用於擷取下一頁結果的符記。在對 insertionOrders.list 方法的後續呼叫時,將這個值傳入 pageToken 欄位,即可擷取下一頁的結果。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-20 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-20 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-20 (世界標準時間)。"]]