Method: listPlannableProducts

傳回可設定指定目標的可按位置計費的 YouTube 廣告格式清單。

擲回的錯誤清單：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v11:listPlannableProducts

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "plannableLocationId": string
}
欄位
plannableLocationId

string

必須提供。您選定的企劃位置編號。如要列出可用的可行位置 ID，請使用 ReachPlanService.ListPlannableLocations。

回應主體

如果執行成功，回應主體中會有結構如下的資料：

回覆內含所有可用產品的回應。

JSON 表示法 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
欄位
productMetadata[]

object (ProductMetadata)

可用於規劃和相關指定目標中繼資料的產品清單。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

產品中繼資料

與可用的可規劃產品相關的中繼資料。

JSON 表示法 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
欄位
plannableProductName

string

與廣告產品相關聯的名稱。
plannableTargeting

object (PlannableTargeting)

允許刊登的這類產品可指定目標。
plannableProductCode

string

與廣告產品相關的代碼 (例如：BUMPER、TRUEVIEW_IN_STREAM)。如要列出可用的可規劃產品代碼，請使用 ReachPlanService.ListPlannableProducts。

可企劃指定目標

用於回報流量指標的指定目標。

JSON 表示法 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ]
}
欄位
ageRanges[]

enum (ReachPlanAgeRange)

系統回報的產品可預訂年齡層，且要回報指標。實際指定目標的計算方式是將年齡範圍對應到標準 Google common.AgeRangeInfo 值。
genders[]

object (GenderInfo)

廣告產品的可指定性別。
devices[]

object (DeviceInfo)

廣告產品的可指定裝置。為 CPM_MASTHEAD、GOOGLE_PREFERRED_BUMPER 和 GOOGLE_PREFERRED_SHORT 產品選取 MOBILE 指定目標後，系統就會自動將 TABLET 指定裝置套用至回報的指標。
networks[]

enum (ReachPlanNetwork)

廣告產品的可指定聯播網。