Method: listPlannableProducts

許可されたターゲティングを含む、地域ごとのプランニング可能な YouTube 広告フォーマットのリストを返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

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 サービスで「MOBILE」ターゲティングが選択されている場合、TABLET デバイス ターゲティングがレポートされる指標に自動的に適用されます。
networks[]

enum (ReachPlanNetwork)

広告プロダクトのターゲットに設定できるネットワーク。
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

ターゲット設定可能な広告サービスの YouTube Select Lineups。
surfaceTargeting

object (SurfaceTargetingCombinations)

広告プロダクトのターゲット設定可能なサーフェスの組み合わせ。

YouTubeSelectLineUp

プロダクト ターゲティング向けの計画可能な YouTube Select Lineups。

JSON 表現 
{
  "lineupId": string,
  "lineupName": string
}
フィールド
lineupId

string (int64 format)

YouTube Select Lineups の ID。
lineupName

string

YouTube Select Lineups の一意の名前。

SurfaceTargetingCombinations

広告プロダクトで使用できるサーフェス ターゲティングの組み合わせです。

JSON 表現 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
フィールド
defaultTargeting

object (SurfaceTargeting)

広告商品に適用されるデフォルトのサーフェス ターゲティングです。
availableTargetingCombinations[]

object (SurfaceTargeting)

広告商品の利用可能なサーフェス ターゲットの組み合わせ。