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)

トラッキング URLTemplate、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

メッセージ アプリに入力されたメッセージ拡張テキスト。

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)

トラッキング URLTemplate、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% に相当します。この値または money_off_amount のいずれかは必須です。
moneyAmountOff

object (Money)

プロモーションの割引による割引額。この値または %Off が必要です。
共用体フィールド 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

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