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

在即时通讯应用中填充的 message extensionText。

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。必须提供此项或 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 之间（包括 1 和 25）。
languageCode

string

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

ImageFeedItem

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

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

string

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