ExtensionFeedItem

附加信息 Feed 项。

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

不可变。附加信息 Feed 项的资源名称。附加信息 Feed 项资源名称采用以下格式：

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

enum (ExtensionType)

仅限输出。附加信息 Feed 项的附加信息类型。此字段为只读字段。
adSchedules[]

object (AdScheduleInfo)

非重叠时间表的列表，用于指定 Feed 项可以投放的所有时间间隔。每天最多可以设置 6 个时间表。
device

enum (FeedItemTargetDevice)

目标设备。
targetedKeyword

object (KeywordInfo)

指定关键字。
status

enum (FeedItemStatus)

仅限输出。Feed 项的状态。此字段为只读字段。
id

string (int64 format)

仅限输出。此 Feed 项的 ID。只读。
startDateTime

string

此 Feed 项生效且可开始投放的开始时间。时间采用客户所在的时区。格式为“YYYY-MM-DD HH:MM:SS”。例如：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
endDateTime

string

此 Feed 项失效并将停止投放的结束时间。时间采用客户所在的时区。格式为“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)

仅限输出。附加地址信息。营业地点会从商家资料同步到 Feed。此字段为只读字段。
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

仅限输出。附加关联商户地址信息。Feed 地址信息由 Google Ads 根据连锁店 ID 填充。此字段为只读字段。
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

酒店附加宣传信息。
imageFeedItem

object (ImageFeedItem)

不可变。广告客户提供的附加图片。
联合字段 serving_resource_targeting。在广告系列或广告组一级进行定位。定位到广告系列或广告组的 Feed 项将只能与该资源一起投放。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

所有跨网域重定向之后可能的最终到达网址的列表。此列表不得为空。
finalMobileUrls[]

string

所有跨网域重定向之后可能的最终到达移动网址列表。
urlCustomParameters[]

object (CustomParameter)

一个映射列表，用于替换 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中的网址自定义参数标记。
linkText

string

在广告中呈现链接时显示的可见文字。此字符串不得为空，并且其长度应介于 1 和 25 之间（含 1 和 25）。
appId

string

目标应用的商店特定 ID。此字符串不能为空。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。默认值为“{lpurl}”。
finalUrlSuffix

string

用于将参数附加到通过并行跟踪投放的着陆页网址的网址模板。

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

广告客户电话号码中由两个字母构成的大写国家/地区代码。此字段是必填字段。
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

此附加价格信息中所有商品的跟踪网址模板。
languageCode

string

此附加价格信息使用的语言代码。
finalUrlSuffix

string

此附加价格信息中所有商品的跟踪网址模板。

PriceOffer

表示附加价格信息中的一项价格优惠。

JSON 表示法 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
字段
price

object (Money)

此优惠的价格值。
unit

enum (PriceExtensionPriceUnit)

此优惠的价格单位。
finalUrls[]

string

所有跨网域重定向之后可能的最终到达网址的列表。
finalMobileUrls[]

string

所有跨网域重定向之后可能的最终到达移动网址列表。
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

所有跨网域重定向之后可能的最终到达网址的列表。此字段是必填字段。
finalMobileUrls[]

string

所有跨网域重定向之后可能的最终到达移动网址列表。
urlCustomParameters[]

object (CustomParameter)

一个映射列表，用于替换 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中的网址自定义参数标记。
promotionTarget

string

对促销活动目标内容的自由格式说明。此字段是必填字段。
promotionStartDate

string

促销活动符合兑换条件的开始日期。
promotionEndDate

string

可以兑换促销优惠的最后日期。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。
finalUrlSuffix

string

用于将参数附加到通过并行跟踪投放的着陆页网址的网址模板。
languageCode

string

促销活动的语言。表示为 BCP 47 语言标记。
联合字段 discount_type。折扣类型，可以是折扣百分比或优惠金额。discount_type 只能是下列其中一项：
percentOff

string (int64 format)

促销活动中的折扣百分比（以微单位表示）。一百万个相当于百分之一。此字段或 amount_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 之间（含 1 和 25）。
languageCode

string

酒店宣传信息文字的语言。符合 IETF BCP 47 要求的语言代码。

ImageFeedItem

表示广告客户提供的附加图片。

JSON 表示法 
{
  "imageAsset": string
}
字段
imageAsset

string

必需。图片资源的资源名称。