多媒體和Video 360 API v2 將於
2024 年 9 月 3 日 停用。請在此之前
遷移至第 3 版 ,以免服務中斷。
提供意見
Method: advertisers.creatives.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives
這個網址使用 gRPC 轉碼 語法。
路徑參數
參數
advertiserId
string (int64 format)
必要欄位。要列出其廣告素材的廣告主 ID。
查詢參數
參數
pageSize
integer
要求的頁面大小。必須介於 1
至 200
之間。如果未指定,則預設值為 100
。如果指定的值無效,則傳回錯誤代碼 INVALID_ARGUMENT
。
pageToken
string
用於識別伺服器應傳回之結果頁面的符記。一般而言,這是從先前呼叫 creatives.list
方法傳回的 nextPageToken
值。如果未指定,系統將傳回第一頁的結果。
orderBy
string
清單排序依據的欄位。可接受的值為:
creativeId
(預設)
createTime
mediaDuration
dimensions
(先依寬度排序,再依高度排序)
預設的排序順序是遞增。如要為欄位指定遞減順序,請在後方加上「desc」即可加入欄位名稱。範例:createTime desc
。
filter
string
可依廣告素材欄位篩選資料。
支援的語法:
篩選器運算式由一或多個限制組成。
限制可用 AND
或 OR
邏輯運算子合併。一組限制會隱含使用 AND
。
限制的形式為 {field} {operator} {value}
。
lineItemIds
欄位必須使用 HAS (:)
運算子。
updateTime
欄位必須使用 GREATER THAN OR EQUAL TO (>=)
或 LESS THAN OR EQUAL TO (<=)
運算子。
所有其他欄位都必須使用 EQUALS (=)
運算子。
針對 entityStatus
、minDuration
、maxDuration
、updateTime
和 dynamic
欄位,最多只能有一個限制。
支援的欄位:
approvalStatus
creativeId
creativeType
dimensions
(以 {width}x{height}
形式輸入)
dynamic
entityStatus
exchangeReviewStatus
(以 {exchange}-{reviewStatus}
形式輸入)
lineItemIds
maxDuration
(以 {duration}s
形式輸入。僅支援秒數)
minDuration
(以 {duration}s
形式輸入。僅支援秒數)
updateTime
(採用 ISO 8601 格式,或 YYYY-MM-DDTHH:MM:SSZ
)
注意:
如果是 updateTime
,廣告素材資源的欄位值反映廣告素材上次更新的時間,包括系統所做的更新 (例如廣告素材審查更新)。
範例:
所有原生廣告素材:creativeType="CREATIVE_TYPE_NATIVE"
所有尺寸為 300x400 或 50x100 的有效廣告素材:entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
通過 AdX 或 AppNexus 核准的動態廣告素材,時間長度下限為 5 秒和 200 毫秒:dynamic="true" AND minDuration="5.2s" AND
(exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED"
OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
與委刊項 ID 1 或 2 相關聯的所有影片廣告素材:creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
按多個廣告素材 ID 尋找廣告素材:creativeId=1 OR creativeId=2
所有更新時間大於或等於 2020-11-04T18:54:47Z 的廣告素材 (格式為 ISO 8601):updateTime>="2020-11-04T18:54:47Z"
這個欄位的長度不得超過 500 個半形字元。
詳情請參閱篩選器 LIST
要求 指南。
回應主體
JSON 表示法
{
"creatives" : [
{
object (Creative
)
}
] ,
"nextPageToken" : string
}
欄位
creatives[]
object (Creative
)
廣告素材清單。
如果留空,這份清單就不會顯示。
nextPageToken
string
用於擷取下一頁結果的符記。在對 ListCreativesRequest
方法的後續呼叫時,將這個值傳入 pageToken
欄位,即可擷取下一頁的結果。如果這個欄位為 null,表示這是最後一頁。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽 。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-22 (世界標準時間)。
[{
"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":"其他"
}]
想進一步說明嗎?
{
"last_modified": "上次更新時間:2024-08-22 (世界標準時間)。",
"state": ""
}