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

在即时通讯应用中填充的附加短信信息 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

此附加价格信息的所有商品的跟踪网址模板。
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)

促销活动的折扣百分比（以微单位表示）。100 万等于百分之 1。必须提供此金额或 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

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