Ad

広告

JSON 表現 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
フィールド
resourceName

string

変更不可。広告のリソース名。広告リソース名の形式は次のとおりです。

customers/{customerId}/ads/{ad_id}
finalUrls[]

string

広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。
finalAppUrls[]

object (FinalAppUrl)

特定のアプリがインストールされている場合にモバイルで使用される、アプリの最終リンク先 URL のリスト。
finalMobileUrls[]

string

広告のすべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate、finalUrls、mobile_final_urls でカスタム パラメータ タグを置き換えるために使用できるマッピングのリスト。ミューテーションには、URL カスタム パラメータ オペレーションを使用します。
type

enum (AdType)

出力専用。広告タイプ。
devicePreference

enum (Device)

広告のデバイス設定。設定を指定できるのはモバイル デバイスに対してのみです。この設定が行われる場合、モバイル デバイスで表示される際に他の広告よりも優先されます。使用可能な他の広告がない場合、広告が他のデバイスタイプでも表示できます。指定しない場合（デバイス設定がない場合）、すべてのデバイスがターゲットになります。これは一部の広告タイプでのみサポートされています。
urlCollections[]

object (UrlCollection)

広告の他のフィールドから参照できる一意の識別子でタグ付けされた、広告の追加 URL。
systemManagedResourceSource

enum (SystemManagedResourceSource)

出力専用。広告がシステムで管理される場合、このフィールドはソースを示します。このフィールドは読み取り専用です。
id

string (int64 format)

出力専用。広告の ID です。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。
finalUrlSuffix

string

最終ページ URL の作成時に使用するサフィックス。
displayUrl

string

一部の広告フォーマットの広告説明に表示される URL。
addedByGoogleAds

boolean

出力専用。この広告がユーザーではなく Google 広告によって自動的に追加されたかどうかを示します。たとえば、既存の広告の成果に基づいて、新しい広告の候補として広告が自動作成される場合があります。
name

string

変更不可。広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。
共用体フィールド ad_data。広告タイプに関連する詳細情報。必ず 1 つ設定する必要があります。ad_data は次のいずれかになります。
textAd

object (TextAdInfo)

変更不可。テキスト広告に関する詳細情報。
expandedTextAd

object (ExpandedTextAdInfo)

拡張テキスト広告に関する詳細情報。
callAd

object (CallAdInfo)

電話専用広告に関する詳細情報。
expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

変更不可。拡張動的検索広告に関する詳細情報。このタイプの広告では、キャンペーン レベルでリンクされた dynamicSearchAdsSetting から提供されるドメイン名固有の情報に基づいて、広告配信時に広告見出し、最終ページ URL、表示 URL が自動生成されます。
hotelAd

object (HotelAdInfo)

ホテル広告に関する詳細。
shoppingSmartAd

object (ShoppingSmartAdInfo)

スマート ショッピング広告に関する詳細情報。
shoppingProductAd

object (ShoppingProductAdInfo)

ショッピング商品広告に関する詳細情報。
imageAd

object (ImageAdInfo)

変更不可。イメージ広告に関する詳細情報。
videoAd

object (VideoAdInfo)

動画広告に関する詳細情報。
videoResponsiveAd

object (VideoResponsiveAdInfo)

レスポンシブ動画広告に関する詳細情報。
responsiveSearchAd

object (ResponsiveSearchAdInfo)

レスポンシブ検索広告に関する詳細。
legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

従来のレスポンシブ ディスプレイ広告に関する詳細。
appAd

object (AppAdInfo)

アプリ広告に関する詳細情報。
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

変更不可。従来のアプリ インストール広告に関する詳細。
responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

レスポンシブ ディスプレイ広告に関する詳細情報。
localAd

object (LocalAdInfo)

ローカル広告に関する詳細情報。
displayUploadAd

object (DisplayUploadAdInfo)

ディスプレイ アップロード広告に関する詳細情報。
appEngagementAd

object (AppEngagementAdInfo)

アプリ エンゲージメント広告に関する詳細。
shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

ショッピング比較広告に関する詳細情報。
smartCampaignAd

object (SmartCampaignAdInfo)

スマート アシスト キャンペーンの広告に関する詳細。
appPreRegistrationAd

object (AppPreRegistrationAdInfo)

アプリの事前登録広告に関する詳細。
demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

デマンド ジェネレーションのマルチアセット広告に関する詳細。
demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

デマンド ジェネレーション動画レスポンシブ広告に関する詳細。
demandGenProductAd

object (DemandGenProductAdInfo)

デマンド ジェネレーション商品広告に関する詳細。
travelAd

object (TravelAdInfo)

旅行広告に関する詳細。

FinalAppUrl

特定のオペレーティング システムのアプリへのディープリンク用の URL。

JSON 表現 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
フィールド
osType

enum (AppUrlOperatingSystemType)

この URL がターゲットとするオペレーティング システム。必須。
url

string

アプリのディープリンク URL。ディープリンクは、表示するコンテンツに対応するアプリ内の場所を指定し、{scheme}://{host_path} の形式にする必要があります。スキームは、開くアプリを識別します。アプリの場合は、アプリの名前で始まるカスタム スキーマを使用できます。ホストとパスは、コンテンツが存在するアプリ内の一意の場所を指定します。例: 「exampleapp://productid_1234」。必須。

AppUrlOperatingSystemType

オペレーティング システム

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
IOS Apple iOS オペレーティング システム。
ANDROID Android オペレーティング システム。

AdType

広告の種類。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは、受信した値は不明です。

これはレスポンス専用の値です。
TEXT_AD 広告がテキスト広告である。
EXPANDED_TEXT_AD 広告が拡張テキスト広告である。
EXPANDED_DYNAMIC_SEARCH_AD 広告が拡張動的検索広告である。
HOTEL_AD 広告がホテル広告である。
SHOPPING_SMART_AD 広告がスマート ショッピング広告である。
SHOPPING_PRODUCT_AD 広告が標準のショッピング広告である。
VIDEO_AD 広告が動画広告である。
IMAGE_AD この広告は画像広告です。
RESPONSIVE_SEARCH_AD 広告がレスポンシブ検索広告である。
LEGACY_RESPONSIVE_DISPLAY_AD 広告が従来のレスポンシブ ディスプレイ広告である。
APP_AD 広告がアプリ広告である。
LEGACY_APP_INSTALL_AD 広告が従来のアプリ インストール広告である。
RESPONSIVE_DISPLAY_AD 広告がレスポンシブ ディスプレイ広告である。
LOCAL_AD 広告がローカル広告である。
HTML5_UPLOAD_AD 広告が、商品カテゴリが HTML5_UPLOAD_AD のディスプレイ広告のアップロード広告である。
DYNAMIC_HTML5_AD 広告が、DYNAMIC_HTML5_* のいずれかの商品カテゴリを持つディスプレイ広告のアップロード広告である。
APP_ENGAGEMENT_AD 広告がアプリ エンゲージメント広告である。
SHOPPING_COMPARISON_LISTING_AD 広告がショッピング比較広告である。
VIDEO_BUMPER_AD 動画バンパー広告。
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 動画のスキップ不可のインストリーム広告。
VIDEO_TRUEVIEW_IN_STREAM_AD 動画の TrueView インストリーム広告。
VIDEO_RESPONSIVE_AD 動画レスポンシブ広告。
SMART_CAMPAIGN_AD スマート アシスト キャンペーンの広告。
CALL_AD 電話専用広告。
APP_PRE_REGISTRATION_AD ユニバーサル アプリの事前登録広告。
IN_FEED_VIDEO_AD インフィード動画広告。
DEMAND_GEN_MULTI_ASSET_AD デマンド ジェネレーションのマルチアセット広告。
TRAVEL_AD 旅行広告。
DEMAND_GEN_VIDEO_RESPONSIVE_AD デマンド ジェネレーション動画レスポンシブ広告。
DEMAND_GEN_PRODUCT_AD デマンド ジェネレーション商品広告。

UrlCollection

一意の識別子でタグ付けされた URL のコレクション。

JSON 表現 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
フィールド
finalUrls[]

string

最終ページ URL の候補のリスト。
finalMobileUrls[]

string

モバイルの最終ページ URL の候補のリスト。
urlCollectionId

string

この UrlCollection インスタンスの一意の識別子。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。

SystemManagedResourceSource

使用可能なシステム管理エンティティ ソースを一覧表示する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
AD_VARIATIONS 生成された広告バリエーション テストの広告。

TextAdInfo

テキスト広告。

JSON 表現 
{
  "headline": string,
  "description1": string,
  "description2": string
}
フィールド
headline

string

広告の見出しです。
description1

string

広告の説明欄の 1 行目。
description2

string

広告の説明欄の 2 行目。

ExpandedTextAdInfo

拡張テキスト広告。

JSON 表現 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
フィールド
headlinePart1

string

広告の見出しの最初の部分。
headlinePart2

string

広告の見出しの 2 番目の部分。
headlinePart3

string

広告の見出しの 3 番目の部分。
description

string

広告の説明。
description2

string

広告の 2 つ目の説明。
path1

string

広告の表示される URL の横に表示できるテキスト。
path2

string

広告の表示される URL の横に表示できる追加テキスト。

CallAdInfo

電話専用広告。

JSON 表現 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
フィールド
countryCode

string

広告の国コード。
phoneNumber

string

広告に記載されている電話番号。
businessName

string

広告内のビジネス名。
headline1

string

広告の最初の見出し。
headline2

string

広告の 2 つ目の見出し。
description1

string

広告の説明欄の 1 行目。
description2

string

広告の説明欄の 2 行目。
callTracked

boolean

クリエイティブで電話のトラッキングを有効にするかどうか。通話トラッキングを有効にすると、通話コンバージョンも有効になります。
disableCallConversion

boolean

クリエイティブでコール コンバージョンを無効にするかどうか。true に設定すると、callTracked が true の場合でもコール コンバージョンが無効になります。callTracked が false の場合、このフィールドは無視されます。
phoneNumberVerificationUrl

string

電話番号確認に使用する URL。
conversionAction

string

電話コンバージョンを割り当てるコンバージョン アクション。設定しない場合、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callTracked が true に設定されている場合にのみ有効です。それ以外の場合、このフィールドは無視されます。
conversionReportingState

enum (CallConversionReportingState)

この電話専用広告の電話コンバージョンの動作。独自の通話コンバージョン設定を使用することも、アカウント単位の設定を継承することも、無効にすることもできます。
path1

string

広告の URL に追加できるテキストの最初の部分です。省略可。
path2

string

広告の URL に追加できるテキストの 2 番目の部分です。このフィールドは、path1 も設定されている場合にのみ設定できます。省略可。

ExpandedDynamicSearchAdInfo

拡張動的検索広告。

JSON 表現 
{
  "description": string,
  "description2": string
}
フィールド
description

string

広告の説明。
description2

string

広告の 2 つ目の説明。

HotelAdInfo

この型にはフィールドがありません。

ホテル広告。

ShoppingSmartAdInfo

この型にはフィールドがありません。

スマート ショッピング広告です。

ShoppingProductAdInfo

この型にはフィールドがありません。

標準のショッピング広告です。

ImageAdInfo

イメージ広告。

JSON 表現 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
フィールド
mimeType

enum (MimeType)

画像の MIME タイプ。
pixelWidth

string (int64 format)

フルサイズの画像の幅（ピクセル単位）。
pixelHeight

string (int64 format)

フルサイズの画像の高さ（ピクセル単位）。
imageUrl

string

フルサイズの画像の URL。
previewPixelWidth

string (int64 format)

プレビュー サイズの画像の幅（ピクセル単位）。
previewPixelHeight

string (int64 format)

プレビュー サイズの画像の高さ（ピクセル単位）。
previewImageUrl

string

プレビューサイズの画像の URL。
name

string

画像の名前。画像が MediaFile から作成された場合は、MediaFile の名前です。イメージがバイトから作成された場合、これは空になります。
共用体フィールド image。ImageAd の作成元となる画像。これは、次の 2 つの方法で指定できます。1. 既存の MediaFile リソース。2. 未加工の画像データ（バイト単位）。image は次のいずれかになります。
imageAsset

object (AdImageAsset)

広告に使用される画像アセット。
data

string (bytes format)

未加工の画像データ（バイト単位）。

Base64 でエンコードされた文字列。
adIdToCopyImageFrom

string (int64 format)

画像のコピー元の広告 ID。

AdImageAsset

広告内で使用される画像アセット。

JSON 表現 
{
  "asset": string
}
フィールド
asset

string

この画像のアセット リソース名。

VideoAdInfo

動画広告。

JSON 表現 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
フィールド
video

object (AdVideoAsset)

広告に使用される YouTube 動画アセット。
共用体フィールド format。さまざまな動画形式に対応した形式固有のスキーマ。format は次のいずれかになります。
inStream

object (VideoTrueViewInStreamAdInfo)

動画の TrueView インストリーム広告フォーマット。
bumper

object (VideoBumperInStreamAdInfo)

動画バンパー インストリーム広告フォーマット。
outStream

object (VideoOutstreamAdInfo)

動画アウトストリーム広告フォーマット。
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

動画のスキップ不可のインストリーム広告フォーマット。
inFeed

object (InFeedVideoAdInfo)

インフィード動画広告フォーマット。

AdVideoAsset

広告内で使用される動画アセット。

JSON 表現 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
フィールド
asset

string

この動画のアセット リソース名。
adVideoAssetInfo

object (AdVideoAssetInfo)

この AdVideoAsset の情報フィールドが含まれます。

AdVideoAssetInfo

AdVideoAssets の情報フィールドが含まれます。

JSON 表現 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
フィールド
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

この AdVideoAsset の広告枠設定のリスト。このフィールドは、DiscoveryVideoResponsiveAd にのみ設定できます。インベントリ アセットの設定が行われた動画アセットは、配信時間中に同じ広告の他の動画よりも優先されます。たとえば、この広告が特定の広告枠に配信されているとします。サーバーはまず、対象となる動画とその広告枠の設定を照合して一致を試みます。設定のない動画が選択されるのは、設定が一致し、特定の広告スロットに適格な動画が見つかった場合のみです。

AdVideoAssetInventoryPreferences

YouTube 動画アセット広告枠の設定。

JSON 表現 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
フィールド
inFeedPreference

boolean

true の場合、フィード内配信する動画を選択する際に、この広告枠設定を持つ YouTube 動画アセットが優先されます。
inStreamPreference

boolean

true の場合、インストリームで配信する動画を選択する際に、この広告枠設定を持つ YouTube 動画アセットが優先されます。
shortsPreference

boolean

true の場合、YouTube ショートに配信する動画を選択する際に、この広告枠設定が設定された YouTube 動画アセットが優先されます。

VideoTrueViewInStreamAdInfo

動画の TrueView インストリーム広告フォーマットの表現（動画再生中に（多くの場合最初に）表示される広告です。動画再生開始の数秒後にスキップボタンが表示されます）。

JSON 表現 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
フィールド
actionButtonLabel

string

動画広告の最終ページ URL にユーザーを誘導する行動を促すフレーズ（CTA）ボタンのラベルです。TrueView アクション キャンペーンでは必須ですが、それ以外の場合は任意です。
actionHeadline

string

行動を促すフレーズ（CTA）ボタンとともに表示される追加のテキスト。コンテキストを示すとともに、ボタンのクリックを促します。
companionBanner

object (AdImageAsset)

広告で使用されるコンパニオン バナーの画像アセット。

VideoBumperInStreamAdInfo

動画バンパーのインストリーム広告フォーマット（非常に短いスキップ不可のインストリーム動画広告）の表現。

JSON 表現 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
フィールド
companionBanner

object (AdImageAsset)

広告で使用されるコンパニオン バナーの画像アセット。
actionButtonLabel

string

動画広告の最終ページ URL にユーザーを誘導する「行動を促すフレーズ」ボタンのラベルです。
actionHeadline

string

行動を促すフレーズ（CTA）ボタンとともに表示される追加のテキスト。コンテキストを示すとともに、ボタンのクリックを促します。

VideoOutstreamAdInfo

動画アウトストリーム広告フォーマットの表現（自動再生でフィードの横に表示される広告、音声なし）。

JSON 表現 
{
  "headline": string,
  "description": string
}
フィールド
headline

string

広告の見出しです。
description

string

説明文。

VideoNonSkippableInStreamAdInfo

動画のスキップ不可のインストリーム広告フォーマット（15 秒間のスキップ不可のインストリーム動画広告）の表現。

JSON 表現 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
フィールド
companionBanner

object (AdImageAsset)

広告で使用されるコンパニオン バナーの画像アセット。
actionButtonLabel

string

動画広告の最終ページ URL にユーザーを誘導する「行動を促すフレーズ」ボタンのラベルです。
actionHeadline

string

コンテキストを伝え、ボタンのクリックを促すために、[行動を促すフレーズ] ボタンとともに表示される追加のテキスト。

InFeedVideoAdInfo

インフィード動画広告フォーマットの表現。

JSON 表現 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
フィールド
headline

string

広告の見出しです。
description1

string

広告の最初のテキスト行。
description2

string

広告の 2 行目のテキストです。
thumbnail

enum (VideoThumbnail)

使用する動画のサムネイル画像。

VideoThumbnail

動画のサムネイルの種類を列挙した列挙型。

列挙型
UNSPECIFIED タイプが指定されていません。
UNKNOWN このバージョンでは、受信した値は不明です。これはレスポンス専用の値です。
DEFAULT_THUMBNAIL デフォルトのサムネイル。自動生成またはユーザーアップロードのいずれかです。
THUMBNAIL_1 動画から生成されたサムネイル 1。
THUMBNAIL_2 動画から生成されたサムネイル 2。
THUMBNAIL_3 動画から生成されたサムネイル 3。

VideoResponsiveAdInfo

動画レスポンシブ広告。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
フィールド
headlines[]

object (AdTextAsset)

短い広告見出しに使用されるテキスト アセットのリスト。現時点では、短いヘッドラインの値は 1 つだけサポートされています。
longHeadlines[]

object (AdTextAsset)

長い広告見出しに使用されるテキスト アセットのリスト。現時点では、長いヘッドラインの値は 1 つだけサポートされています。
descriptions[]

object (AdTextAsset)

説明に使用されるテキスト アセットのリスト。現時点では、説明の値は 1 つだけサポートされています。
callToActions[]

object (AdTextAsset)

ボタンに使用されるテキスト アセットのリスト（「行動を促すフレーズ」ボタンなど）。現時点では、ボタンの値は 1 つだけサポートされています。
videos[]

object (AdVideoAsset)

広告に使用されている YouTube 動画アセットのリスト。現在、YouTube 動画アセットの値は 1 つのみサポートされています。
companionBanners[]

object (AdImageAsset)

コンパニオン バナーに使用される画像アセットのリスト。現在、コンパニオン バナー アセットの値は 1 つのみサポートされています。
breadcrumb1

string

広告に表示される URL とともに広告に表示されるテキストの最初の部分。
breadcrumb2

string

広告に表示される URL とともに広告に表示されるテキストの 2 番目の部分。

ResponsiveSearchAdInfo

レスポンシブ検索広告。

レスポンシブ検索広告では、より豊富なテキストを使って、ユーザーに関連性の高いメッセージを表示する広告を作成できます。レスポンシブ検索広告の作成時に複数の広告見出しと説明文を入力しておくと、その後 Google 広告によってさまざまな組み合わせが自動的にテストされ、掲載結果が最も高い組み合わせが使用されます。レスポンシブ検索広告では、広告のコンテンツとユーザーの検索語句との関連性が高まるように調整されるため、キャンペーンのパフォーマンス向上を見込めます。

詳しくは、https://support.google.com/google-ads/answer/7684791 をご覧ください。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
フィールド
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。
descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。
path1

string

広告の URL に追加できるテキストの最初の部分です。
path2

string

広告の URL に追加できるテキストの 2 番目の部分です。このフィールドは、path1 も設定されている場合にのみ設定できます。

LegacyResponsiveDisplayAdInfo

従来のレスポンシブ ディスプレイ広告です。このタイプの広告は、Google 広告の UI では「レスポンシブ広告」と表示されます。

JSON 表現 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
フィールド
formatSetting

enum (DisplayAdFormatSetting)

広告が配信されるフォーマットを指定します。デフォルトは ALL_FORMATS です。
shortHeadline

string

広告の見出しの短いバージョン。
longHeadline

string

広告の見出しの長いバージョン。
description

string

広告の説明。
businessName

string

広告内のビジネス名。
allowFlexibleColor

boolean

さまざまな色を許可することに対する広告主の同意。true の場合、必要に応じて広告の色が変更されることがあります。false に設定すると、指定した色または中間色で広告が配信されます。デフォルト値は true です。mainColor と accentColor が設定されていない場合は true にする必要があります。
accentColor

string

広告のアクセント カラー。16 進数で指定します。例: 白の場合は #ffffff。mainColor と accentColor のいずれかが設定されている場合は、もう一方も必要です。
mainColor

string

広告のメインカラー。16 進数で指定します。例: 白の場合は #ffffff。mainColor と accentColor のいずれかが設定されている場合は、もう一方も必要です。
callToActionText

string

広告のカスタム外部リンクのテキスト。
logoImage

string

広告で使用されるロゴ画像の MediaFile リソース名。
squareLogoImage

string

広告で使用されるスクエアのロゴ画像の MediaFile リソース名。
marketingImage

string

広告で使用されるマーケティング画像の MediaFile リソース名。
squareMarketingImage

string

広告で使用されるスクエアのマーケティング画像の MediaFile リソース名。
pricePrefix

string

価格の前に表示される文字列。例: 「as low as」。
promoText

string

レスポンシブ広告の動的フォーマットに使用されるプロモーション テキスト。例: 「2 日以内での無料配送」

DisplayAdFormatSetting

ディスプレイ広告のフォーマット設定を列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
ALL_FORMATS テキスト、画像、ネイティブ形式。
NON_NATIVE テキストと画像の形式。
NATIVE ネイティブ形式: 形式のレンダリングは Google ではなくパブリッシャーによって制御されます。

AppAdInfo

アプリ広告です。

JSON 表現 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
フィールド
mandatoryAdText

object (AdTextAsset)

必須の広告文。
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。
descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。
images[]

object (AdImageAsset)

広告と一緒に表示される画像アセットのリスト。
youtubeVideos[]

object (AdVideoAsset)

広告と一緒に表示される YouTube 動画アセットのリスト。
html5MediaBundles[]

object (AdMediaBundleAsset)

広告で使用できるメディア バンドル アセットのリスト。

AdMediaBundleAsset

広告内で使用されるメディア バンドル アセット。

JSON 表現 
{
  "asset": string
}
フィールド
asset

string

このメディア バンドルのアセット リソース名。

AdAppDeepLinkAsset

広告内で使用されるアプリ ディープリンク。

JSON 表現 
{
  "asset": string
}
フィールド
asset

string

このアプリのディープリンク アセットのアセット リソース名。

LegacyAppInstallAdInfo

一部のお客様のみが使用できる従来のアプリ インストール広告。

JSON 表現 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
フィールド
appStore

enum (LegacyAppInstallAdAppStore)

モバイルアプリが利用できるアプリストア。
appId

string

モバイルアプリの ID。
headline

string

広告の見出しです。
description1

string

広告の説明欄の 1 行目。
description2

string

広告の 2 行目の説明文。

LegacyAppInstallAdAppStore

従来のアプリ インストール広告のアプリストア タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play
WINDOWS_STORE Windows ストア。
WINDOWS_PHONE_STORE Windows Phone ストア。
CN_APP_STORE アプリが中国のアプリストアでホストされている。

ResponsiveDisplayAdInfo

レスポンシブ ディスプレイ広告。

JSON 表現 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
フィールド
marketingImages[]

object (AdImageAsset)

広告で使用されるマーケティング画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 600 x 314 ピクセル、アスペクト比は 1.91:1（+-1%）である必要があります。少なくとも 1 つの marketingImage が必要です。squareMarketingImages と組み合わせる場合、最大 15 になります。
squareMarketingImages[]

object (AdImageAsset)

広告で使用されるスクエアのマーケティング画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 300×300 ピクセル、アスペクト比は 1:1（+-1%）にする必要があります。少なくとも 1 つの正方形の marketingImage が必要です。marketingImages と組み合わせる場合、最大 15 になります。
logoImages[]

object (AdImageAsset)

広告で使用されるロゴ画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 512 x 128 で、アスペクト比は 4:1（+-1%）にする必要があります。squareLogoImages と組み合わせる場合、最大数は 5 です。
squareLogoImages[]

object (AdImageAsset)

広告で使用されるスクエアのロゴ画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 128 x 128 で、アスペクト比は 1:1（+-1%）にする必要があります。logoImages と組み合わせる場合、最大数は 5 です。
headlines[]

object (AdTextAsset)

広告の短い形式の広告見出し。最大で 30 文字です。広告見出しは 1 つ以上 5 つまで指定できます。
longHeadline

object (AdTextAsset)

必須の長い広告見出し。最大で 90 文字です。
descriptions[]

object (AdTextAsset)

広告の説明文。最大で 90 文字です。広告見出しは 1 つ以上 5 つまで指定できます。
youtubeVideos[]

object (AdVideoAsset)

広告のオプションの YouTube 動画です。指定できる動画は 5 本までです。
formatSetting

enum (DisplayAdFormatSetting)

広告が配信されるフォーマットを指定します。デフォルトは ALL_FORMATS です。
controlSpec

object (ResponsiveDisplayAdControlSpec)

各種クリエイティブ コントロールの仕様。
businessName

string

広告主またはブランドの名前。最大表示幅は 25 です。
mainColor

string

広告のメインカラー。16 進数で指定します。例: 白の場合は #ffffff。mainColor と accentColor のいずれかが設定されている場合は、もう一方も必要です。
accentColor

string

広告のアクセント カラー。16 進数で指定します。例: 白の場合は #ffffff。mainColor と accentColor のいずれかが設定されている場合は、もう一方も必要です。
allowFlexibleColor

boolean

さまざまな色を許可することに対する広告主の同意。true の場合、必要に応じて広告の色が変更されることがあります。false に設定すると、指定した色または中間色で広告が配信されます。デフォルト値は true です。mainColor と accentColor が設定されていない場合は true にする必要があります。
callToActionText

string

広告のカスタム外部リンクのテキスト。最大表示幅は 30 です。
pricePrefix

string

価格の前に表示される文字列。例: 「as low as」。
promoText

string

レスポンシブ広告の動的フォーマットに使用されるプロモーション テキスト。例: 「2 日以内での無料配送」

ResponsiveDisplayAdControlSpec

レスポンシブ ディスプレイ広告のさまざまなクリエイティブ管理機能の仕様。

JSON 表現 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
フィールド
enableAssetEnhancements

boolean

広告主がアセットの拡張機能にオプトインしているかどうか。
enableAutogenVideo

boolean

広告主様が動画の自動生成機能を有効にしているかどうか。

LocalAdInfo

ローカル広告。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
フィールド
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。1 ～ 5 個の広告見出しを指定する必要があります。
descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。1 ～ 5 個の説明を指定する必要があります。
callToActions[]

object (AdTextAsset)

行動を促すフレーズのテキスト アセットのリスト。広告が配信されると、このリストから行動を促すフレーズが選択されます。少なくとも 1 つ、最大 5 つの行動を促すフレーズを指定する必要があります。
marketingImages[]

object (AdImageAsset)

広告と一緒に表示されるマーケティング用画像アセットのリスト。画像のサイズは 314 x 600 ピクセルまたは 320 x 320 ピクセルである必要があります。1 ～ 20 個の画像アセットを指定する必要があります。
logoImages[]

object (AdImageAsset)

広告と一緒に表示されるロゴ画像アセットのリスト。画像は 128 x 128 ピクセルで、120 KB 以下にする必要があります。1 ～ 5 個の画像アセットを指定する必要があります。
videos[]

object (AdVideoAsset)

広告と一緒に表示される YouTube 動画アセットのリスト。1 ～ 20 個の動画アセットを指定する必要があります。
path1

string

広告の URL に追加できるオプションのテキストの最初の部分。
path2

string

広告の URL に追加できるオプションのテキストの 2 番目の部分。このフィールドは、path1 も設定されている場合にのみ設定できます。

DisplayUploadAdInfo

一般的なタイプのディスプレイ広告です。正確な広告フォーマットは displayUploadProductType フィールドで制御され、このフィールドによって広告に含める必要があるデータの種類が決まります。

JSON 表現 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
フィールド
displayUploadProductType

enum (DisplayUploadProductType)

この広告の商品カテゴリ。詳細については、列挙型のコメントをご覧ください。
共用体フィールド media_asset。広告を構成するアセットデータ。media_asset は次のいずれかになります。
mediaBundle

object (AdMediaBundleAsset)

広告で使用するメディア バンドル アセット。HTML5_UPLOAD_AD のメディア バンドルについては、https://support.google.com/google-ads/answer/1722096 をご覧ください。動的商品タイプの一部であるメディア バンドルは、Google Web Designer で作成する必要がある特別な形式を使用します。詳しくは、https://support.google.com/webdesigner/answer/7543898 をご覧ください。

DisplayUploadProductType

ディスプレイ広告のアップロードする商品カテゴリを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
HTML5_UPLOAD_AD HTML5 アップロード広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。
DYNAMIC_HTML5_EDUCATION_AD 動的 HTML5 教育広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。教育キャンペーンでのみ使用できます。
DYNAMIC_HTML5_FLIGHT_AD 動的 HTML5 フライト広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。フライト キャンペーンでのみ使用できます。
DYNAMIC_HTML5_HOTEL_RENTAL_AD 動的 HTML5 ホテルと民泊施設の広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ホテル キャンペーンでのみ使用できます。
DYNAMIC_HTML5_JOB_AD 動的 HTML5 求人広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。求人キャンペーンでのみ使用できます。
DYNAMIC_HTML5_LOCAL_AD 動的 HTML5 ローカル広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ローカル キャンペーンでのみ使用できます。
DYNAMIC_HTML5_REAL_ESTATE_AD 動的 HTML5 不動産広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。不動産キャンペーンでのみ使用できます。
DYNAMIC_HTML5_CUSTOM_AD 動的 HTML5 カスタム広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。カスタム キャンペーンでのみ使用できます。
DYNAMIC_HTML5_TRAVEL_AD 動的 HTML5 旅行広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。旅行キャンペーンでのみ使用できます。
DYNAMIC_HTML5_HOTEL_AD 動的 HTML5 ホテル広告。このプロダクト タイプでは、DisplayUploadAdInfo の upload_media_bundle フィールドを設定する必要があります。ホテル キャンペーンでのみ使用できます。

AppEngagementAdInfo

アプリ エンゲージメント広告を使用すると、チェックイン、購入、航空券の予約といった、アプリ内での特定のアクションを促す広告文を作成できます。アプリ エンゲージメント広告でアプリ内の特定の場所に誘導されたユーザーは、必要な情報をより早く簡単に見つけることができます。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
フィールド
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。
descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。
images[]

object (AdImageAsset)

広告と一緒に表示される画像アセットのリスト。
videos[]

object (AdVideoAsset)

広告と一緒に表示される動画アセットのリスト。

ShoppingComparisonListingAdInfo

ショッピング比較広告です。

JSON 表現 
{
  "headline": string
}
フィールド
headline

string

広告の見出し。このフィールドは必須です。長さは 25 ～ 45 文字の範囲で指定してください。

AppPreRegistrationAdInfo

アプリの事前登録広告は、Google Play のアプリやゲームの掲載情報にリンクされ、Google Play、YouTube（インストリームのみ）、ディスプレイ ネットワークの他のアプリやモバイルサイトに掲載されます。アプリやゲームに対するユーザーの関心を引き付け、アプリやゲームのリリース前の段階で初期的なユーザー ベースを構築できます。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
フィールド
headlines[]

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信される際、ヘッドラインはこのリストから選択されます。
descriptions[]

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信される際、このリストから説明が選択されます。
images[]

object (AdImageAsset)

広告と一緒に表示される画像の画像アセット ID のリスト。
youtubeVideos[]

object (AdVideoAsset)

広告と一緒に表示される可能性がある YouTube 動画アセット ID のリスト。

DemandGenMultiAssetAdInfo

デマンド ジェネレーションのマルチアセット広告。

JSON 表現 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
フィールド
marketingImages[]

object (AdImageAsset)

広告で使用されるマーケティング画像アセット。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 600 x 314 ピクセル、アスペクト比は 1.91:1（+-1%）である必要があります。squareMarketingImages が存在しない場合は必須です。squareMarketingImages、portraitMarketingImages、tallPortraitMarketingImages と組み合わせて使用する場合、最大数は 20 です。
squareMarketingImages[]

object (AdImageAsset)

広告で使用されるスクエアのマーケティング画像アセット。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 300×300 ピクセル、アスペクト比は 1:1（+-1%）にする必要があります。marketingImages が存在しない場合は必須です。marketingImages、portraitMarketingImages、tallPortraitMarketingImages と組み合わせて使用する場合、最大数は 20 です。
portraitMarketingImages[]

object (AdImageAsset)

広告で使用される縦向きのマーケティング画像アセット。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 480 x 600 ピクセル、アスペクト比は 4:5（+-1%）にする必要があります。marketingImages、squareMarketingImages、tallPortraitMarketingImages と組み合わせて使用する場合、最大数は 20 です。
tallPortraitMarketingImages[]

object (AdImageAsset)

広告で使用される縦長のマーケティング画像アセット。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 600 x 1067 ピクセル、アスペクト比は 9:16（+-1%）にする必要があります。marketingImages、squareMarketingImages、portraitMarketingImages を組み合わせた最大数は 20 です。
logoImages[]

object (AdImageAsset)

広告で使用されるロゴ画像アセット。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 128 x 128 で、アスペクト比は 1:1（+-1%）にする必要があります。ロゴ画像は 1 個以上、最大 5 個指定できます。
headlines[]

object (AdTextAsset)

広告の見出しテキスト アセット。最大表示幅は 30 です。広告見出しは 1 つ以上 5 つまで指定できます。
descriptions[]

object (AdTextAsset)

広告の説明文。最大表示幅は 90 です。1 ～ 5 個の説明文を指定できます。
businessName

string

広告主またはブランドの名前。最大表示幅は 25 です。必須。
callToActionText

string

行動を促すフレーズのテキスト。
leadFormOnly

boolean

この広告をリードフォームとともに配信する必要があるかどうかを示すブール値オプション。

DemandGenCarouselAdInfo

デマンド ジェネレーション カルーセル広告。

JSON 表現 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
フィールド
businessName

string

必須。広告主またはブランドの名前。
logoImage

object (AdImageAsset)

必須。広告で使用されるロゴ画像。最小サイズは 128 x 128 で、アスペクト比は 1:1（+-1%）にする必要があります。
headline

object (AdTextAsset)

必須。広告のタイトルです。
description

object (AdTextAsset)

必須。広告の説明文。
callToActionText

string

行動を促すフレーズのテキスト。
carouselCards[]

object (AdDemandGenCarouselCardAsset)

必須。広告とともに表示されるカルーセル カード。最小 2、最大 10。

AdDemandGenCarouselCardAsset

広告内で使用されるデマンド ジェネレーション カルーセル カード アセット。

JSON 表現 
{
  "asset": string
}
フィールド
asset

string

このファインド カルーセル カードのアセット リソース名。

DemandGenVideoResponsiveAdInfo

デマンド ジェネレーション動画レスポンシブ広告。

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
フィールド
headlines[]

object (AdTextAsset)

短い広告見出しに使用されるテキスト アセットのリスト。
longHeadlines[]

object (AdTextAsset)

長い広告見出しに使用されるテキスト アセットのリスト。
descriptions[]

object (AdTextAsset)

説明に使用されるテキスト アセットのリスト。
videos[]

object (AdVideoAsset)

広告に使用されている YouTube 動画アセットのリスト。
logoImages[]

object (AdImageAsset)

広告で使用されるロゴ画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 128 x 128 で、アスペクト比は 1:1（+-1%）にする必要があります。
breadcrumb1

string

広告に表示される URL とともに広告に表示されるテキストの最初の部分。
breadcrumb2

string

広告に表示される URL とともに広告に表示されるテキストの 2 番目の部分。
businessName

object (AdTextAsset)

必須。広告主またはブランドの名前。
callToActions[]

object (AdCallToActionAsset)

「行動を促すフレーズ」ボタンに使用される CallToActionAsset タイプのアセット。

AdCallToActionAsset

広告内で使用される行動を促すフレーズ アセット。

JSON 表現 
{
  "asset": string
}
フィールド
asset

string

この行動を促すフレーズのアセットのアセット リソース名。

DemandGenProductAdInfo

デマンド ジェネレーション商品広告。

JSON 表現 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
フィールド
breadcrumb1

string

広告に表示される URL とともに広告に表示されるテキストの最初の部分。
breadcrumb2

string

広告に表示される URL とともに広告に表示されるテキストの 2 番目の部分。
businessName

object (AdTextAsset)

必須。広告主またはブランドの名前。
headline

object (AdTextAsset)

必須。短い広告見出しに使用されるテキスト アセット。
description

object (AdTextAsset)

必須。説明に使用されるテキスト アセット。
logoImage

object (AdImageAsset)

必須。広告で使用されるロゴ画像。使用可能な画像形式は GIF、JPEG、PNG です。最小サイズは 128 x 128 で、アスペクト比は 1:1（+-1%）にする必要があります。
callToAction

object (AdCallToActionAsset)

[行動を促すフレーズ] ボタンに使用される CallToActionAsset タイプのアセット。

TravelAdInfo

この型にはフィールドがありません。

旅行広告。