多媒體和Video 360 API v2 將於
2024 年 9 月 3 日 停用。請在此之前
遷移至第 3 版 ,以免服務中斷。
提供意見
Method: advertisers.youtubeAdGroupAds.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
多媒體和Video 360 API 第 2 版已淘汰,並將於日後停用
2024 年 9 月 3 日 。請參閱遷移指南 ,瞭解如何遷移至 v3。
HTTP 要求
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroupAds
這個網址使用 gRPC 轉碼 語法。
路徑參數
參數
advertiserId
string (int64 format)
必要欄位。廣告群組所屬的廣告主編號。
查詢參數
參數
pageSize
integer
要求的頁面大小。必須介於 1
至 100
之間。如果未指定,則預設值為 100
。如果指定的值無效,則傳回錯誤代碼 INVALID_ARGUMENT
。
pageToken
string
用於識別伺服器應傳回之結果頁面的符記。一般而言,這是從先前呼叫 youtubeAdGroupAds.list
方法傳回的 nextPageToken
值。如果未指定,系統將傳回第一頁的結果。
orderBy
string
清單排序依據的欄位。可接受的值為:
displayName
(預設)
entityStatus
預設的排序順序是遞增。如要為欄位指定遞減順序,請在後方加上「desc」即可加入欄位名稱。範例:displayName desc
。
filter
string
允許按自訂 YouTube 廣告群組廣告欄位進行篩選。
支援的語法:
篩選器運算式由一或多個限制組成。
限制可以用 AND
和 OR
合併。一組限制會隱含使用 AND
。
限制的形式為 {field} {operator} {value}
。
所有欄位都必須使用 EQUALS (=)
運算子。
支援的欄位:
adGroupId
displayName
entityStatus
adGroupAdId
範例:
一個廣告群組中的所有廣告群組廣告:adGroupId="1234"
廣告群組中實體狀態為 ENTITY_STATUS_ACTIVE
或 ENTITY_STATUS_PAUSED
的所有廣告群組廣告:(entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupId="12345"
這個欄位的長度不得超過 500 個半形字元。
詳情請參閱篩選器 LIST
要求 指南。
回應主體
JSON 表示法
{
"youtubeAdGroupAds" : [
{
object (YoutubeAdGroupAd
)
}
] ,
"nextPageToken" : string
}
欄位
youtubeAdGroupAds[]
object (YoutubeAdGroupAd
)
廣告群組廣告清單。
如果留空,這份清單就不會顯示。
nextPageToken
string
用於擷取下一頁結果的符記。在對 youtubeAdGroupAds.list
方法的後續呼叫時,將這個值傳入 pageToken
欄位,即可擷取下一頁的結果。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽 。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-21 (世界標準時間)。
[{
"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-21 (世界標準時間)。",
"state": ""
}