REST Resource: customers.ads

{
  "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)
  },
  "discoveryMultiAssetAd": {
    object (DiscoveryMultiAssetAdInfo)
  },
  "discoveryCarouselAd": {
    object (DiscoveryCarouselAdInfo)
  },
  "discoveryVideoResponsiveAd": {
    object (DiscoveryVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

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

customers/{customerId}/ads/{ad_id}

string

広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。

object (FinalAppUrl)

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

string

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

object (CustomParameter)

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

enum (AdType)

出力のみ。広告タイプ。

enum (Device)

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

object (UrlCollection)

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

enum (SystemManagedResourceSource)

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

string (int64 format)

出力のみ。広告の ID。

string

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

string

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

string

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

boolean

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

string

変更不可。広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。

object (TextAdInfo)

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

object (ExpandedTextAdInfo)

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

object (CallAdInfo)

電話専用広告に関する詳細です。

object (ExpandedDynamicSearchAdInfo)

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

object (HotelAdInfo)

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

object (ShoppingSmartAdInfo)

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

object (ShoppingProductAdInfo)

ショッピング広告に関する詳細です。

object (ImageAdInfo)

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

object (VideoAdInfo)

動画広告に関する詳細です。

object (VideoResponsiveAdInfo)

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

object (ResponsiveSearchAdInfo)

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

object (LegacyResponsiveDisplayAdInfo)

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

object (AppAdInfo)

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

object (LegacyAppInstallAdInfo)

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

object (ResponsiveDisplayAdInfo)

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

object (LocalAdInfo)

ローカル広告に関する詳細です。

object (DisplayUploadAdInfo)

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

object (AppEngagementAdInfo)

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

object (ShoppingComparisonListingAdInfo)

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

object (SmartCampaignAdInfo)

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

object (AppPreRegistrationAdInfo)

アプリ事前登録広告に関する詳細情報です。

object (DiscoveryMultiAssetAdInfo)

ファインド マルチアセット広告に関する詳細です。

object (DiscoveryCarouselAdInfo)

ファインド カルーセル広告に関する詳細情報です。

object (DiscoveryVideoResponsiveAdInfo)

ファインド動画レスポンシブ広告に関する詳細です。

object (DemandGenProductAdInfo)

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

object (TravelAdInfo)

旅行の広告に関する詳細。

{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}

enum (AppUrlOperatingSystemType)

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

string

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

{
  "key": string,
  "value": string
}

string

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

string

置換される値。

{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}

string

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

string

有効なモバイルの最終ページ URL のリスト。

string

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

string

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

{
  "headline": string,
  "description1": string,
  "description2": string
}

string

広告の見出し。

string

広告の説明欄の 1 行目。

string

広告の説明欄の 2 行目。

{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}

string

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

string

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

string

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

string

広告の説明。

string

広告の 2 番目の説明文。

string

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

string

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

{
  "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
}

string

広告の国コード。

string

広告内の電話番号。

string

広告内のビジネスの名前。

string

広告の最初の見出し。

string

広告の 2 番目の見出し。

string

広告の説明欄の 1 行目。

string

広告の説明欄の 2 行目。

boolean

クリエイティブのコール トラッキングを有効にするかどうかを指定します。コール トラッキングを有効にすると、コール コンバージョンも有効になります。

boolean

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

string

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

string

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

enum (CallConversionReportingState)

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

string

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

string

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

{
  "description": string,
  "description2": string
}

string

広告の説明。

string

広告の 2 番目の説明文。

{
  "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.
}

enum (MimeType)

画像の MIME タイプ。

string (int64 format)

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

string (int64 format)

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

string

フルサイズの画像の URL。

string (int64 format)

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

string (int64 format)

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

string

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

string

画像の名前。画像が MediaFile から作成された場合は、MediaFile の名前です。画像がバイトから作成された場合、これは空です。

object (AdImageAsset)

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

string (bytes format)

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

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

string (int64 format)

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

{
  "asset": string
}

string

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

{
  "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.
}

object (AdVideoAsset)

広告に使用された YouTube 動画アセット。

object (VideoTrueViewInStreamAdInfo)

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

object (VideoBumperInStreamAdInfo)

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

object (VideoOutstreamAdInfo)

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

object (VideoNonSkippableInStreamAdInfo)

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

object (InFeedVideoAdInfo)

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

{
  "asset": string
}

string

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

{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}

string

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

string

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

object (AdImageAsset)

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

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

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

string

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

string

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

{
  "headline": string,
  "description": string
}

string

広告の見出し。

string

説明文。

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

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

string

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

string

コンテキストを示し、ボタンをクリックするよう促すために、「行動を促すフレーズ」ボタンとともに表示される追加のテキスト。

{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}

string

広告の見出し。

string

広告の 1 行目のテキスト。

string

広告の 2 行目のテキスト。

enum (VideoThumbnail)

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}

object (AdTextAsset)

短い広告見出しに使用されるテキスト アセットのリスト。現在、短い広告見出しに指定できる値は 1 つのみです。

object (AdTextAsset)

長い広告見出しに使用されるテキスト アセットのリスト。現在、長い広告見出しでサポートされている値は 1 つのみです。

object (AdTextAsset)

説明文に使用されるテキスト アセットのリスト。現在、商品説明に指定できる値は 1 つのみです。

object (AdTextAsset)

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

object (AdVideoAsset)

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

object (AdImageAsset)

コンパニオン バナーに使用する画像アセットのリストです。現在、コンパニオン バナー アセットで使用できる値は 1 つのみです。

string

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

string

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

{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}

enum (ServedAssetFieldType)

アセットの固定フィールド。これにより、アセットはこのフィールド内でのみ配信されるようになります。同じフィールドに複数のアセットを固定できます。固定されていないアセット、または別のフィールドに固定されているアセットは、他のアセットが固定されているフィールドには配信されません。

enum (AssetPerformanceLabel)

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

object (AdAssetPolicySummary)

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

string

アセットのテキスト。

{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}

object (PolicyTopicEntry)

このアセットに対するポリシーの検出結果のリスト。

enum (PolicyReviewStatus)

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

enum (PolicyApprovalStatus)

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

{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}

enum (PolicyTopicEntryType)

このポリシーが配信に対して与えるプラスまたはマイナスの影響を表します。

object (PolicyTopicEvidence)

ポリシーの検出を説明する追加情報（商標の検出結果のブランド名など）。

object (PolicyTopicConstraint)

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

string

この検出結果が参照するポリシー トピック。例: 「ALCOHOL」、「TRADEMARKS_IN_AD_TEXT」、「DESTINATION_NOT_WORKING」。取り得るポリシー トピックのセットは、特定の API バージョンに対して固定されておらず、いつでも変更される可能性があります。

{

  // 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.
}

object (WebsiteList)

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

object (TextList)

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

string

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

object (DestinationTextList)

ポリシーの検出の原因となったリソースの宛先のテキスト。

object (DestinationMismatch)

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

object (DestinationNotWorking)

一般的に使用されるデバイスのリンク先で HTTP エラーコードが返された場合や、一部の地域で機能しない場合の詳細が表示されます。

{
  "websites": [
    string
  ]
}

string

ポリシー違反の検出の原因となったウェブサイト。

{
  "texts": [
    string
  ]
}

string

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

{
  "destinationTexts": [
    string
  ]
}

string

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

{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

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

{
  "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.
}

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

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

string

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

string

URL が最後に確認された時刻。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS エラーのタイプ。

string (int64 format)

HTTP エラーコード。

{

  // 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.
}

object (CountryConstraintList)

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

object (ResellerConstraint)

販売パートナーの制約。

object (CountryConstraintList)

配信に証明書が必要な国です。

object (CountryConstraintList)

リソースのドメインが、関連する証明書でカバーされていない国。

{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}

object (CountryConstraint)

配信が制限されている国。

integer

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

{
  "countryCriterion": string
}

string

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。

object (AdTextAsset)

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

string

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

string

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

{
  "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
}

enum (DisplayAdFormatSetting)

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

string

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

string

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

string

広告の説明。

string

広告内のビジネスの名前。

boolean

柔軟な色の使用を許可する広告主の同意。true の場合、広告は必要に応じて別の色で配信されます。false の場合、広告は指定した色またはニュートラル カラーで配信されます。デフォルト値は true です。mainColor と accentColor が設定されていない場合は true にする必要があります。

string

広告のアクセント カラー（16 進数）。たとえば、白の場合は #ffffff となります。mainColor または accentColor のいずれかが設定されている場合は、もう一方も必須です。

string

広告のメインの色（16 進数）。たとえば、白の場合は #ffffff です。mainColor または accentColor のいずれかが設定されている場合は、もう一方も必須です。

string

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

string

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

string

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

string

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

string

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

string

価格の前にプレフィックスを付けます。例: 「同程度」。

string

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

{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}

object (AdTextAsset)

必須の広告文。

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。

object (AdTextAsset)

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

object (AdImageAsset)

広告とともに表示できる画像アセットのリストです。

object (AdVideoAsset)

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

object (AdMediaBundleAsset)

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

{
  "asset": string
}

string

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

{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}

enum (LegacyAppInstallAdAppStore)

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

string

モバイルアプリの ID。

string

広告の見出し。

string

広告の 1 行目の説明。

string

広告の説明文の 2 行目。

{
  "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
}

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

長いフォーマットの広告見出し（必須）。最大で 90 文字です。

object (AdTextAsset)

広告用の説明文。最大で 90 文字です。広告見出しは 1 ～ 5 個指定できます。

object (AdVideoAsset)

広告のオプションの YouTube 動画です。最大 5 本の動画を指定できます。

enum (DisplayAdFormatSetting)

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

object (ResponsiveDisplayAdControlSpec)

さまざまなクリエイティブ コントロールの仕様。

string

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

string

広告のメインの色（16 進数）。たとえば、白の場合は #ffffff です。mainColor または accentColor のいずれかが設定されている場合は、もう一方も必須です。

string

広告のアクセント カラー（16 進数）。たとえば、白の場合は #ffffff となります。mainColor または accentColor のいずれかが設定されている場合は、もう一方も必須です。

boolean

柔軟な色の使用を許可する広告主の同意。true の場合、広告は必要に応じて別の色で配信されます。false の場合、広告は指定した色またはニュートラル カラーで配信されます。デフォルト値は true です。mainColor と accentColor が設定されていない場合は true にする必要があります。

string

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

string

価格の前にプレフィックスを付けます。例: 「同程度」。

string

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

{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}

boolean

広告主様がアセットの改善機能を有効にしているかどうか。

boolean

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。広告見出しは 1 ～ 5 個指定する必要があります。

object (AdTextAsset)

説明のテキスト アセットのリスト。広告が配信されるときに、このリストから説明文が選択されます。説明文は 1 ～ 5 個指定する必要があります。

object (AdTextAsset)

行動を促すフレーズのテキスト アセットのリスト。広告が配信されるときに、このリストから行動を促すフレーズが選択されます。行動を促すフレーズは 1 ～ 5 個指定する必要があります。

object (AdImageAsset)

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

object (AdImageAsset)

広告に表示できるロゴ画像アセットのリストです。画像は 128×128 ピクセル、120 KB 以下である必要があります。画像アセットは 1 ～ 5 個指定する必要があります。

object (AdVideoAsset)

広告とともに表示できる YouTube 動画アセットのリストです。動画アセットは 1 ～ 20 個指定する必要があります。

string

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

string

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

{
  "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.
}

enum (DisplayUploadProductType)

この広告の商品カテゴリ。詳細については、列挙型のコメントをご覧ください。

object (AdMediaBundleAsset)

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。

object (AdTextAsset)

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

object (AdImageAsset)

広告とともに表示できる画像アセットのリストです。

object (AdVideoAsset)

広告とともに表示できる動画アセットのリストです。

{
  "headline": string
}

string

広告の見出し。このフィールドは必須です。指定できる長さは 25 ～ 45 文字です。

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}

object (AdTextAsset)

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

object (AdTextAsset)

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

広告見出しのテキスト アセットのリスト。広告が配信されるときに、このリストから広告見出しが選択されます。

object (AdTextAsset)

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

object (AdImageAsset)

広告に表示できる画像アセット ID のリストです。

object (AdVideoAsset)

広告とともに動画を表示できる YouTube 動画アセット ID のリストです。

{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

広告で使用するロゴ画像アセット。有効な画像形式は GIF、JPEG、PNG です。最小サイズは 128×128、アスペクト比は 1:1（+-1%）にする必要があります。ロゴ画像は 1 ～ 5 個指定できます。

object (AdTextAsset)

広告の見出しのテキスト アセット。最大表示幅は 30 です。広告見出しは 1 ～ 5 個指定できます。

object (AdTextAsset)

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

string

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

string

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

boolean

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

{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}

string

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

object (AdImageAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

必須。広告の説明テキスト。

string

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

object (AdDiscoveryCarouselCardAsset)

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

{
  "asset": string
}

string

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

{
  "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)
    }
  ]
}

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdVideoAsset)

広告に使用される YouTube 動画アセットのリスト。

object (AdImageAsset)

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

string

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

string

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

object (AdTextAsset)

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

object (AdCallToActionAsset)

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

{
  "asset": string
}

string

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

{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}

string

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

string

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

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

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

object (AdCallToActionAsset)

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