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 テンプレート。

App Store

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

列挙型
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

メッセージ アプリに入力されたメッセージ表示オプションのテキスト。

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 は次のいずれかになります。
percentOff

string (int64 format)

プロモーションの割引率（マイクロ秒単位）。100 万は 1% に相当します。この金額または currency_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

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