Method: listPlannableProducts

傳回每個地區可規劃的 YouTube 廣告格式清單，其中包含允許的指定目標。

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

HTTP 要求

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

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

要求主體

要求主體的資料會採用以下結構：

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

string

必要欄位。所選地區用於規劃的 ID。如要列出可用的預定位置 ID，請使用 ReachPlanService.ListPlannableLocations。

回應主體

傳回所有適用產品的回應。

如果成功，回應主體即會包含具有以下結構的資料：

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

object (ProductMetadata)

可供規劃及相關指定目標中繼資料的產品清單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ProductMetadata

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

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

string

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

object (PlannableTargeting)

這項產品允許的可規劃指定目標。
plannableProductCode

string

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

PlannableTargeting

要記錄流量指標的指定目標。

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

enum (ReachPlanAgeRange)

產品允許在報表中顯示指標的適用年齡層範圍。實際指定目標的計算方法是將這個年齡層對應至標準 Google Common.AgeRangeInfo 值。
genders[]

object (GenderInfo)

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

object (DeviceInfo)

廣告產品的可指定裝置。為「CPM_MASTHEAD」、「GOOGLE_PREFERRED_BUMPER」和「GOOGLE_PREFERRED_SHORT」產品選取「行動裝置」指定目標時，TABLET 裝置指定目標會自動套用至報表的指標。
networks[]

enum (ReachPlanNetwork)

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

object (YouTubeSelectLineUp)

廣告產品可指定的 YouTube Select 首選頻道。
surfaceTargeting

object (SurfaceTargetingCombinations)

廣告產品的可指定介面組合。

YouTubeSelectLineUp

可規劃的 YouTube Select 首選頻道，以便指定產品。

JSON 表示法 
{
  "lineupId": string,
  "lineupName": string
}
欄位
lineupId

string (int64 format)

YouTube Select 首選頻道的 ID。
lineupName

string

YouTube Select 首選頻道的專屬名稱。

SurfaceTargetingCombinations

廣告產品可用的途徑指定目標組合。

JSON 表示法 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
欄位
defaultTargeting

object (SurfaceTargeting)

已套用至廣告產品的預設途徑指定目標。
availableTargetingCombinations[]

object (SurfaceTargeting)

廣告產品可用的表面目標組合。