- HTTP 要求
- 要求主體
- 回應主體
- 授權範圍
- ProductMetadata
- PlannableTargeting
- YouTubeSelectLineUp
- SurfaceTargetingCombinations
- 試試看!
根據允許的指定目標,傳回按地區規劃的 YouTube 廣告格式清單。
擲回錯誤清單:AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v15:listPlannableProducts
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "plannableLocationId": string } |
欄位 | |
---|---|
plannableLocationId |
必要欄位。所選地點的 ID,以便進行規劃。如要列出可用的可規劃地區 ID,請使用 |
回應主體
回覆包括所有可用產品。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"productMetadata": [
{
object ( |
欄位 | |
---|---|
productMetadata[] |
可供規劃的產品清單和相關指定目標中繼資料。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
ProductMetadata
與可用規劃產品相關聯的中繼資料。
JSON 表示法 |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
欄位 | |
---|---|
plannableProductName |
與廣告產品相關聯的名稱。 |
plannableTargeting |
這項產品允許的規劃指定目標。 |
plannableProductCode |
與廣告產品相關聯的代碼 (例如:BUMPER、TRUEVIEW_IN_STREAM)。如要列出可用的可規劃產品代碼,請使用 |
PlannableTargeting
要記錄流量指標的指定目標。
JSON 表示法 |
---|
{ "ageRanges": [ enum ( |
欄位 | |
---|---|
ageRanges[] |
產品允許用於記錄指標的可規劃年齡層。實際指定目標的計算方式是將這個年齡層對應到標準 Google Common.AgeRangeInfo 值。 |
genders[] |
廣告產品可指定的性別。 |
devices[] |
廣告產品的指定裝置。為 CPM_MASTHEAD、GOOGLE_PREFERRED_BUMPER 和 GOOGLE_PREFERRED_SHORT 產品選取行動指定目標時,系統就會自動將 TABLET 指定裝置套用到報表指標。 |
networks[] |
廣告產品的可指定聯播網。 |
youtubeSelectLineups[] |
廣告產品可指定的 YouTube Select 首選頻道。 |
surfaceTargeting |
廣告產品的可指定介面組合。 |
YouTubeSelectLineUp
用於指定產品的可規劃 YouTube Select 首選頻道。
JSON 表示法 |
---|
{ "lineupId": string, "lineupName": string } |
欄位 | |
---|---|
lineupId |
YouTube Select 首選頻道的 ID。 |
lineupName |
YouTube Select 首選頻道的專屬名稱。 |
SurfaceTargetingCombinations
廣告產品可用的表面指定組合。
JSON 表示法 |
---|
{ "defaultTargeting": { object ( |
欄位 | |
---|---|
defaultTargeting |
已套用至廣告產品的預設途徑。 |
availableTargetingCombinations[] |
廣告產品可用的表面目標組合。 |