REST Resource: customers.ads

FinalAppUrl

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

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

enum (AppUrlOperatingSystemType)

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

string

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

AppUrlOperatingSystemType

OS

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

CustomParameter

trackingUrlTemplate、finalUrls、mobile_final_urls のカスタム パラメータ タグで使用できるマッピング。

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string

パラメータタグ名と一致するキー。
value

string

置換される値。

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_OUTSTREAM_AD アウトストリーム動画広告です。
VIDEO_TRUEVIEW_IN_STREAM_AD 動画 TrueView インストリーム広告。
VIDEO_RESPONSIVE_AD 動画レスポンシブ広告
SMART_CAMPAIGN_AD スマート アシスト キャンペーンの広告です。
CALL_AD 電話専用広告。
APP_PRE_REGISTRATION_AD ユニバーサル アプリ事前登録広告。
IN_FEED_VIDEO_AD インフィード動画広告。
DISCOVERY_MULTI_ASSET_AD ファインド マルチアセット広告。
TRAVEL_AD 旅行の広告。
DISCOVERY_VIDEO_RESPONSIVE_AD ファインド動画レスポンシブ広告です。

デバイス

ターゲティングに使用できる Google 広告デバイスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
MOBILE フル インターネット ブラウザ搭載のモバイル デバイス
TABLET フル インターネット ブラウザ搭載のタブレット。
DESKTOP パソコン、
CONNECTED_TV スマートテレビとゲーム機
OTHER その他のデバイスタイプ。

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 も設定されている場合にのみ設定できます。省略可。

CallConversionReportingState

通話コンバージョン アクションの状態に使用できるデータ型です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DISABLED 通話コンバージョン アクションは無効になっています。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、アカウント単位で設定された通話コンバージョンの種類が使用されます。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、リソース（電話専用広告/電話番号表示オプション）レベルで設定された通話コンバージョンの種類が使用されます。

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)

バイト単位の RAW 画像データ。

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

string (int64 format)

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

MimeType

MIME タイプ

列挙型
UNSPECIFIED MIME タイプが指定されていません。
UNKNOWN

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
IMAGE_JPEG image/jpeg の MIME タイプ。
IMAGE_GIF 画像/GIF の MIME タイプ。
IMAGE_PNG 画像/png の MIME タイプ。
FLASH application/x-shockwave-flash の MIME タイプ。
TEXT_HTML text/html の MIME タイプ。
PDF アプリケーション/PDF の MIME タイプ。
MSWORD アプリケーション/ミリ秒の MIME タイプ。
MSEXCEL application/vnd.ms-excel の MIME タイプ。
RTF application/rtf の MIME タイプ。
AUDIO_WAV Audio/wav の MIME タイプ。
AUDIO_MP3 Audio/mp3 の MIME タイプ。
HTML5_AD_ZIP application/x-html5-ad-zip の MIME タイプ。

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
}
フィールド
asset

string

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

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 番目の部分です。

AdTextAsset

広告内で使用されるテキスト アセット。

JSON 表現 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
フィールド
pinnedField

enum (ServedAssetFieldType)

アセットの固定フィールド。これにより、そのアセットがこのフィールドでのみ配信されるよう制限されます。同じ項目に複数のアセットを固定できます。固定を解除したアセットや、別の項目に固定されているアセットは、他のアセットが固定されているフィールドには配信されません。
assetPerformanceLabel

enum (AssetPerformanceLabel)

このテキスト アセットのパフォーマンス ラベル。
policySummaryInfo

object (AdAssetPolicySummary)

このテキスト アセットのポリシーの概要。
text

string

アセットのテキスト。

ServedAssetFieldType

使用可能なアセット フィールド タイプ。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
HEADLINE_1 アセットが広告見出し 1 で使用されている。
HEADLINE_2 アセットは広告見出し 2 で使用されます。
HEADLINE_3 アセットが広告見出し 3 で使用されている。
DESCRIPTION_1 アセットは説明文 1 で使用されています。
DESCRIPTION_2 アセットは説明文 2 で使用されています。
HEADLINE アセットが広告見出しで使用されている。広告見出しが 1 つだけの場合にのみ使用します。それ以外の場合は、HEADLINE_1、HEADLINE_2、または HEADLINE_3 列挙型を使用してください
HEADLINE_IN_PORTRAIT アセットが縦向き画像の見出しとして使用されていました。
LONG_HEADLINE アセットが長い広告見出しで使用されています（MultiAsset レスポンシブ Ad で使用）。
DESCRIPTION アセットが説明文で使用された。広告内の説明文が 1 つのみの場合にのみ使用します。それ以外の場合は、DESCRIPTION_1 または DESCRIPTION_@ 列挙型を使用します。
DESCRIPTION_IN_PORTRAIT アセットが縦向きの画像の説明として使用されていました。
BUSINESS_NAME_IN_PORTRAIT アセットが縦向き画像のビジネス名として使用されていました。
BUSINESS_NAME アセットがビジネス名として使用されていた。
MARKETING_IMAGE アセットがマーケティング画像として使用された。
MARKETING_IMAGE_IN_PORTRAIT アセットが縦向き画像でマーケティング画像として使用されていた。
SQUARE_MARKETING_IMAGE アセットはスクエアのマーケティング画像として使用された。
PORTRAIT_MARKETING_IMAGE このアセットは縦向きのマーケティング画像として使用されました。
CALL_TO_ACTION アセットが行動を促すフレーズとして使用された。
YOU_TUBE_VIDEO アセットが YouTube 動画として使用されていた。
CALL このアセットは通話として使用されます。
MOBILE_APP このアセットはモバイルアプリとして使用されています。
CALLOUT このアセットはコールアウトとして使用されます。
STRUCTURED_SNIPPET このアセットは構造化スニペットとして使用されます。
PRICE このアセットは価格として使用されます。
PROMOTION このアセットはプロモーションとして使用されます。
AD_IMAGE このアセットは画像として使用されます。
LEAD_FORM アセットがリードフォームとして使用されます。

AssetPerformanceLabel

アセットのパフォーマンス ラベルを示す列挙型。通常はリンクのコンテキストで計算されます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING このアセットには、まだパフォーマンスに関する情報がありません。原因としては、まだ審査中であることが考えられます。
LEARNING アセットのインプレッションが開始されていますが、アセットのパフォーマンス ラベルを取得するのに十分な統計的有意性がありません。
LOW 最もパフォーマンスが低いアセット。
GOOD パフォーマンスの高いアセットです。
BEST パフォーマンスが特に高いアセット。

AdAssetPolicySummary

広告内のアセットのポリシー情報が含まれます。

JSON 表現 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
フィールド
policyTopicEntries[]

object (PolicyTopicEntry)

このアセットのポリシー検出結果のリスト。
reviewStatus

enum (PolicyReviewStatus)

このアセットは審査プロセスのどの段階にあるか。
approvalStatus

enum (PolicyApprovalStatus)

このアセットの全体的な承認ステータス。個々のポリシー トピック エントリのステータスに基づいて計算されます。

PolicyTopicEntry

リソースに添付されたポリシーの検出結果（アルコールを販売するサイトに関連付けられているアルコールに関するポリシーなど）。

各 PolicyTopicEntry には、エントリが対象とする特定の広告ポリシーを示すトピックと、エントリが配信に与える影響を示すタイプがあります。検出結果の理由を示す 1 つ以上の証拠を含めることもできます。また、オプションとして、配信をどのように制限するかの詳細を指定する制約を 1 つ以上設定することもできます。

JSON 表現 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
フィールド
type

enum (PolicyTopicEntryType)

このポリシーの広告配信に与える悪影響またはプラスの効果を表します。
evidences[]

object (PolicyTopicEvidence)

ポリシーによる検出について説明する追加情報（商標に関する検出の場合のブランド名など）。
constraints[]

object (PolicyTopicConstraint)

このリソースの配信にどのような影響があるかを示します（ある国で広告が配信されないなど）。
topic

string

この検出結果に関連するポリシーのトピック。たとえば、「ALCOHOL」、「TRADEMARKS_IN_AD_TEXT」、「DESTINATION_NOT_WORKING」などです。使用可能なポリシー トピックのセットは、特定の API バージョンに対して固定されているわけではなく、いつでも変更される可能性があります。

PolicyTopicEntryType

有効なポリシー トピックのエントリタイプ。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
PROHIBITED リソースは提供されません。
LIMITED 状況によってはリソースが提供されない。
FULLY_LIMITED 現在のターゲティング条件では、リソースをまったく配信できません。
DESCRIPTIVE 関心があるかもしれませんが、リソースの提供方法を限定しません。
BROADENING 通常よりカバレッジが高くなる可能性がある。
AREA_OF_INTEREST_ONLY すべての対象国で制約されますが、関心のある地域を通じて他の国でも配信される可能性があります。

PolicyTopicEvidence

ポリシーの検出結果を説明する追加情報。

JSON 表現 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
フィールド
共用体フィールド value。証拠の種類に応じた、特定の証拠の情報。value は次のいずれかになります。
websiteList

object (WebsiteList)

このリソースにリンクされているウェブサイトのリスト。
textList

object (TextList)

リソースのテキスト内で見つかった証拠のリスト。
languageCode

string

リソースが検出された言語。これは、「en-US」などの IETF 言語タグです。
destinationTextList

object (DestinationTextList)

ポリシーの検出結果の原因となっているリソースの宛先のテキスト。
destinationMismatch

object (DestinationMismatch)

リソースの URL の宛先が一致しない。
destinationNotWorking

object (DestinationNotWorking)

リンク先が HTTP エラーコードを返している場合や、よく使用されるデバイスのすべての地域で機能していない場合の詳細。

WebsiteList

ポリシーに関する検出の原因となったウェブサイトのリスト。たとえば、ONE_WEBSITE_PER_AD_GROUP ポリシー トピックに使用されます。5 つ以上のウェブサイトがある場合は、上位 5（リソースに最も多く表示されるもの）のみがここに表示されます。

JSON 表現 
{
  "websites": [
    string
  ]
}
フィールド
websites[]

string

ポリシーに関する検出の原因となったウェブサイト。

TextList

ポリシーに違反しているテキストの一部のリスト。

JSON 表現 
{
  "texts": [
    string
  ]
}
フィールド
texts[]

string

ポリシーの検出結果の原因となったリソースのテキストのフラグメント。

DestinationTextList

リンク先ページで見つかった、ポリシーの検出結果の原因となった文字列のリスト。

JSON 表現 
{
  "destinationTexts": [
    string
  ]
}
フィールド
destinationTexts[]

string

リソースのリンク先ページにあるテキストのリスト。

DestinationMismatch

リソースの URL が一致しない証拠。

JSON 表現 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
フィールド
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

互いに一致しない URL のセット。

PolicyTopicEvidenceDestinationMismatchUrlType

ポリシー トピックの証拠となるリンク先の不一致の URL タイプ。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
DISPLAY_URL 表示 URL。
FINAL_URL 最終ページ URL
FINAL_MOBILE_URL モバイルの最終ページ URL
TRACKING_URL トラッキング URL テンプレート（パソコン用 URL が代用されています）。
MOBILE_TRACKING_URL トラッキング URL テンプレート（代替のモバイル URL）

DestinationNotWorking

宛先が HTTP エラーコードを返している場合や、よく使用されるデバイスのすべてのロケーションで機能していない場合の詳細。

JSON 表現 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
フィールド
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

URL の読み込みに失敗したデバイスの種類。
expandedUrl

string

機能しなかった完全な URL。
lastCheckedDateTime

string

URL が最後に確認された時刻。形式は「YYYY-MM-DD HH:MM:SS」です。例: 「2018-03-05 09:15:00」または「2018-02-01 14:34:30」
共用体フィールド reason。DESTINATION_NOT_WORKING ポリシーで検出された理由を示します。reason は次のいずれかになります。
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS エラーのタイプ。
httpErrorCode

string (int64 format)

HTTP エラーコード。

PolicyTopicEvidenceDestinationNotWorkingDevice

ポリシー トピックのエビデンスのリンク先が機能していないデバイスである可能性があります。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
DESKTOP ランディング ページがデスクトップ デバイスで機能しません。
ANDROID ランディング ページが Android デバイスで機能しません。
IOS ランディング ページが iOS デバイスで機能しません。

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

ポリシー トピックの証拠の宛先が機能していない DNS エラータイプ。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
HOSTNAME_NOT_FOUND ランディング ページの取得時に DNS でホスト名が見つかりませんでした。
GOOGLE_CRAWLER_DNS_ISSUE DNS との通信中に Google 内部のクローラーに問題が発生しました。このエラーは、ランディング ページが機能していないことを意味するものではありません。ランディング ページは再クロールされます。

PolicyTopicConstraint

ポリシー トピック エントリが与える影響を記述します。

JSON 表現 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
フィールド
共用体フィールド value。制約に関する特定の情報。value は次のいずれかになります。
countryConstraintList

object (CountryConstraintList)

リソースを提供できない国。
resellerConstraint

object (ResellerConstraint)

販売パートナーの制約。
certificateMissingInCountryList

object (CountryConstraintList)

広告配信に証明書が必要な国。
certificateDomainMismatchInCountryList

object (CountryConstraintList)

リソースのドメインが、関連付けられている証明書の対象外である国。

CountryConstraintList

リソースの提供が制限されている国のリスト。

JSON 表現 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
フィールド
countries[]

object (CountryConstraint)

広告配信が制限される国
totalTargetedCountries

integer

リソースのターゲットとなる国の合計数。

CountryConstraint

特定の国でリソースのサービスを提供する能力が制限されていることを示します。

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

string

広告配信が制限されている国の地域ターゲティング定数リソース名。

ResellerConstraint

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

再販業者としてのウェブサイトの不承認により、ポリシー項目が制約を受けたことを示します。

PolicyReviewStatus

ポリシー審査のステータス。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
REVIEW_IN_PROGRESS 現在審査中です。
REVIEWED 一次審査が完了しました。他の審査は引き続き継続される場合があります。
UNDER_APPEAL リソースが承認のために再送信されたか、ポリシーに関する決定に対して再審査請求が行われました。
ELIGIBLE_MAY_SERVE リソースは適格で、提供されている可能性がありますが、さらなる審査が行われる可能性があります。

PolicyApprovalStatus

ポリシーの承認ステータス。複数の承認ステータスがある場合は、最も重大なものが使用されます。重大度の順序は、DISAPPROVED、AREA_OF_INTEREST_ONLY、APPROVED_LIMITED、APPROVED です。

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

受け取った値は、このバージョンでは不明です。

これはレスポンス専用の値です。
DISAPPROVED 配信されません。
APPROVED_LIMITED 制限付きで配信されます。
APPROVED 制限なしで配信されます。
AREA_OF_INTEREST_ONLY ターゲットに設定した国では配信されませんが、その国の情報を検索するユーザーには表示されます。

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

従来のレスポンシブ ディスプレイ広告です。この種類の広告には「レスポンシブ広告」というラベルが表示されますクリックします

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

価格の前に接頭辞を付けます。（例: 「最低価格」）。
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)
    }
  ]
}
フィールド
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

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

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×314 で、アスペクト比は 1.91:1（+-1%）である必要があります。少なくとも 1 つの marketingImage が必要です。squareMarketingImages と組み合わせると最大値は 15 になります。
squareMarketingImages[]

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

広告で使用されるスクエアのロゴ画像。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×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

価格の前に接頭辞を付けます。（例: 「最低価格」）。
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)

広告とともに表示できるマーケティング画像アセットのリストです。画像は 314x600 ピクセルまたは 320x320 ピクセルである必要があります。画像アセットは 1 ～ 20 個指定する必要があります。
logoImages[]

object (AdImageAsset)

広告とともに表示されるロゴ画像アセットのリストです。画像は 128×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 文字で指定してください。

SmartCampaignAdInfo

スマート アシスト キャンペーン広告

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

object (AdTextAsset)

テキスト アセットのリスト。各アセットは、広告配信時の広告見出しに対応します。このリストは、3 ～ 15 個のテキスト アセットで構成されます。
descriptions[]

object (AdTextAsset)

テキスト アセットのリスト。それぞれが、広告配信時の説明文に対応しています。このリストは、2 ～ 4 個のテキスト アセットで構成されます。

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 のリストです。

DiscoveryMultiAssetAdInfo

ファインド マルチアセット広告。

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

object (AdImageAsset)

広告で使用するマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 600×314 で、アスペクト比は 1.91:1（+-1%）である必要があります。sceneMarketingImages が存在しない場合は必須です。squareMarketingImages および portraitMarketingImages と合わせた最大値は 20 です。
squareMarketingImages[]

object (AdImageAsset)

広告で使用するスクエアのマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 300×300 で、アスペクト比は 1:1（+-1%）である必要があります。MarketingImages が存在しない場合は必須です。marketingImages および portraitMarketingImages と合わせた最大値は 20 です。
portraitMarketingImages[]

object (AdImageAsset)

広告で使用する縦向きのマーケティング画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 480×600、アスペクト比は 4:5（+-1%）である必要があります。marketingImages および squareMarketingImages と合わせた最大値は 20 です。
logoImages[]

object (AdImageAsset)

広告で使用するロゴ画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×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

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

DiscoveryCarouselAdInfo

ファインド カルーセル広告。

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

string

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

object (AdImageAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

必須。広告の説明文です。
callToActionText

string

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

object (AdDiscoveryCarouselCardAsset)

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

AdDiscoveryCarouselCardAsset

広告内で使用されるファインド カルーセル カード アセット。

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

string

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

DiscoveryVideoResponsiveAdInfo

ファインド動画レスポンシブ広告

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×128 で、アスペクト比は 1:1（+-1%）である必要があります。
breadcrumb1

string

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

string

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

object (AdTextAsset)

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

object (AdCallToActionAsset)

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

AdCallToActionAsset

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

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

string

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

TravelAdInfo

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

旅行の広告。

メソッド

get

 リクエストされた広告に関する詳細情報を返します。

mutate

 広告を更新します。