- HTTP リクエスト
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- ProductMetadata
- PlannableTargeting
- YouTubeSelectLineUp
- SurfaceTargetingCombinations
- 試してみる
地域ごとに、許可されているターゲティングを含む計画可能な YouTube 広告フォーマットのリストを返します。
スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP リクエスト
POST https://googleads.googleapis.com/v16:listPlannableProducts
この URL は gRPC Transcoding 構文を使用します。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
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 のサービスで「MOBILE」ターゲティングが選択されている場合、TABLET デバイス ターゲティングがレポートされる指標に自動的に適用されます。 |
networks[] |
広告プロダクトのターゲットに設定できるネットワーク。 |
youtubeSelectLineups[] |
広告プロダクトのターゲティング可能な YouTube Select Lineups。 |
surfaceTargeting |
広告プロダクトのターゲットに設定可能なサーフェスの組み合わせ。 |
YouTubeSelectLineUp
商品ターゲティング用の Plannable YouTube Select Lineups。
JSON 表現 |
---|
{ "lineupId": string, "lineupName": string } |
フィールド | |
---|---|
lineupId |
YouTube Select Lineups の ID。 |
lineupName |
YouTube Select Lineups の一意の名前。 |
SurfaceTargetingCombinations
広告プロダクトで利用できるサーフェス ターゲティングの組み合わせ。
JSON 表現 |
---|
{ "defaultTargeting": { object ( |
フィールド | |
---|---|
defaultTargeting |
広告プロダクトに適用されるデフォルトのサーフェス ターゲティング。 |
availableTargetingCombinations[] |
広告プロダクトで利用可能なサーフェス ターゲットの組み合わせ。 |