Method: listPlannableProducts

根據允許的指定目標，傳回按地區規劃的 YouTube 廣告格式清單。

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

HTTP 要求

POST https://googleads.googleapis.com/v15: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)

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