ExtensionFeedItem

広告表示オプションのフィード アイテム。

JSON 表現 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
フィールド
resourceName

string

変更不可。広告表示オプションのフィード アイテムのリソース名。広告表示オプションのフィード アイテムのリソース名の形式:

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

出力のみ。広告表示オプションのフィード アイテムの広告表示オプションの種類。このフィールドは読み取り専用です。
adSchedules[]

object (AdScheduleInfo)

フィード アイテムを配信する可能性のあるすべての期間を指定する、重複しないスケジュールのリスト。1 日に作成できるスケジュールは最大 6 個です。
device

enum (FeedItemTargetDevice)

ターゲット デバイス。
targetedKeyword

object (KeywordInfo)

ターゲットとなるキーワード。
status

enum (FeedItemStatus)

出力のみ。フィード アイテムのステータス。このフィールドは読み取り専用です。
id

string (int64 format)

出力のみ。このフィード アイテムの ID。読み取り専用です。
startDateTime

string

このフィード アイテムが有効で配信を開始できる開始時間。時刻はお客様のタイムゾーンで表記されます。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"
endDateTime

string

このフィード アイテムが無効になり、配信が終了する終了時間。時刻はお客様のタイムゾーンで表記されます。形式は「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"
targetedGeoTargetConstant

string

ターゲットとする地域ターゲティングの定数。
共用体フィールド extension。広告表示オプションの種類。extension は次のいずれかになります。
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

構造化スニペット表示オプション。
appFeedItem

object (AppFeedItem)

アプリリンク表示オプション。
callFeedItem

object (CallFeedItem)

電話番号表示オプション
calloutFeedItem

object (CalloutFeedItem)

コールアウト表示オプション。
textMessageFeedItem

object (TextMessageFeedItem)

テキスト メッセージ表示オプション。
priceFeedItem

object (PriceFeedItem)

価格表示オプション。
promotionFeedItem

object (PromotionFeedItem)

プロモーション表示オプション] を選択します。
locationFeedItem

object (LocationFeedItem)

出力のみ。住所表示オプション。ビジネス情報は、ビジネス プロフィールからフィードに同期されます。このフィールドは読み取り専用です。
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

出力のみ。アフィリエイト住所表示オプション。フィードの地域は、チェーン ID に基づいて Google 広告によって入力されます。このフィールドは読み取り専用です。
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

ホテルのコールアウト表示オプション
imageFeedItem

object (ImageFeedItem)

変更不可。広告主様が指定した画像表示オプション。
共用体フィールド serving_resource_targeting。キャンペーン単位または広告グループ単位でターゲティングできます。キャンペーンまたは広告グループをターゲットとするフィード アイテムは、そのリソースでのみ配信されます。serving_resource_targeting は次のいずれかになります。
targetedCampaign

string

ターゲットとなるキャンペーン。
targetedAdGroup

string

ターゲットに設定した広告グループ。

StructuredSnippetFeedItem

構造化スニペット表示オプションを表します。

JSON 表現 
{
  "values": [
    string
  ],
  "header": string
}
フィールド
values[]

string

スニペットの値。このコレクションの最大サイズは 10 です。
header

string

スニペットのヘッダー。この文字列を空にすることはできません。

AppFeedItem

アプリリンク表示オプションを表します。

JSON 表現 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
フィールド
appStore

enum (AppStore)

ターゲット アプリケーションが属するアプリケーション ストア。このフィールドは必須です。
finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。このリストは必ず入力してください。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。
urlCustomParameters[]

object (CustomParameter)

TrackingUrlTemplate、finalUrls、finalMobileUrls の URL カスタム パラメータ タグの置換に使用するマッピングのリスト。
linkText

string

広告でリンクがレンダリングされるときに表示されるテキスト。この文字列を空にすることはできません。また、この文字列の長さは 1 ～ 25 にする必要があります。
appId

string

ターゲット アプリケーションのストア固有の ID。この文字列を空にすることはできません。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。デフォルト値は「{lpurl}」です。
finalUrlSuffix

string

並行トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。

AppStore

アプリリンク表示オプションのアプリストアのタイプです。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
APPLE_ITUNES Apple iTunes。
GOOGLE_PLAY Google Play。

TextMessageFeedItem

ユーザーがクリックすると、広告主にテキスト メッセージを送信できる拡張機能です。

JSON 表現 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
フィールド
businessName

string

メッセージ テキストの先頭に付加するビジネス名です。このフィールドは必須です。
countryCode

string

広告主の電話番号の大文字の 2 文字の国コード。このフィールドは必須です。
phoneNumber

string

メッセージの送信先である広告主の電話番号。必須。
text

string

広告に表示するテキストです。このフィールドは必須です。
extensionText

string

メッセージ アプリに入力されたメッセージ表示オプション Text。

PriceFeedItem

価格表示オプションを表します。

JSON 表現 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
フィールド
type

enum (PriceExtensionType)

この広告表示オプションの価格表示オプションのタイプです。
priceQualifier

enum (PriceExtensionPriceQualifier)

この価格表示オプションのすべての商品の価格種別です。
priceOfferings[]

object (PriceOffer)

この価格表示オプションの価格商品です。
trackingUrlTemplate

string

この価格表示オプションのすべての商品情報のトラッキング URL テンプレート。
languageCode

string

この価格表示オプションで使用される言語コードです。
finalUrlSuffix

string

この価格表示オプションのすべての商品情報のトラッキング URL テンプレート。

PriceOffer

価格表示オプションの 1 つの価格を表示します。

JSON 表現 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
フィールド
price

object (Money)

このオファーの価格値。
unit

enum (PriceExtensionPriceUnit)

このオファーの価格単位。
finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。
header

string

このオファーのヘッダー テキスト。
description

string

この特典の説明テキスト。

PromotionFeedItem

プロモーション表示オプションを表します。

JSON 表現 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
フィールド
discountModifier

enum (PromotionExtensionDiscountModifier)

割引の条件を変更する列挙型。
occasion

enum (PromotionExtensionOccasion)

プロモーションの目的。行事を設定した場合、クーポンの利用期間は、行事に関連付けられた期間内に設定する必要があります。
finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。このフィールドは必須です。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。
urlCustomParameters[]

object (CustomParameter)

TrackingUrlTemplate、finalUrls、finalMobileUrls の URL カスタム パラメータ タグの置換に使用するマッピングのリスト。
promotionTarget

string

プロモーションの対象に関する自由形式の説明です。このフィールドは必須です。
promotionStartDate

string

プロモーションの利用対象となる開始日。
promotionEndDate

string

プロモーションが利用可能な最終日。
trackingUrlTemplate

string

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

string

並行トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。
languageCode

string

プロモーションの言語。BCP 47 言語タグで表されます。
共用体フィールド discount_type。割引の種類。割引率または割引額を指定できます。discount_type には次のいずれか 1 つだけを指定できます。
percentOff

string (int64 format)

プロモーションの割引率（マイクロ単位）。100 万は 1% に相当します。これまたは money_off_amount のいずれかが必要です。
moneyAmountOff

object (Money)

プロモーションの割引額。これか percentOff のいずれかが必要です。
共用体フィールド promotion_trigger。プロモーション トリガー。プロモーション コードによる場合と、対象となる注文額によるプロモーションによる場合があります。promotion_trigger は次のいずれかになります。
promotionCode

string

プロモーションの対象となるためにユーザーが使用する必要があるコード。
ordersOverAmount

object (Money)

ユーザーがプロモーションの対象となるために必要な注文合計額。

LocationFeedItem

住所表示オプションを表します。

JSON 表現 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
フィールド
businessName

string

ビジネスの名前。
addressLine1

string

ビジネス拠点の住所の 1 行目。
addressLine2

string

ビジネス拠点の住所の 2 行目。
city

string

ビジネス拠点の住所の市区町村。
province

string

ビジネスの住所の都道府県。
postalCode

string

ビジネス拠点の住所の郵便番号。
countryCode

string

ビジネス拠点の住所の国コード。
phoneNumber

string

ビジネスの電話番号。

AffiliateLocationFeedItem

アフィリエイト住所表示オプションを表します。

JSON 表現 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
フィールド
businessName

string

ビジネスの名前。
addressLine1

string

ビジネス拠点の住所の 1 行目。
addressLine2

string

ビジネス拠点の住所の 2 行目。
city

string

ビジネス拠点の住所の市区町村。
province

string

ビジネスの住所の都道府県。
postalCode

string

ビジネス拠点の住所の郵便番号。
countryCode

string

ビジネス拠点の住所の国コード。
phoneNumber

string

ビジネスの電話番号。
chainId

string (int64 format)

商品の販売者として宣伝されている小売チェーンの ID。
chainName

string

チェーン名。

HotelCalloutFeedItem

ホテルのコールアウト表示オプションを表します。

JSON 表現 
{
  "text": string,
  "languageCode": string
}
フィールド
text

string

コールアウトのテキスト。この文字列の長さは 1～25 で指定します。
languageCode

string

ホテルのコールアウト テキストの言語。IETF BCP 47 準拠の言語コード。

ImageFeedItem

広告主が提供する画像表示オプションを表します。

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

string

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