Feed

Feed。

JSON 表示法 
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
字段
resourceName

string

不可变。Feed 的资源名称。Feed 资源名称采用以下格式：

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

Feed 的属性。创建时必填，除非提供了 system_feed_generation_data，在这种情况下，Google Ads 会使用正确的属性更新 Feed。不允许在 UPDATE 中使用。使用 attributeOperations 添加新属性。
attributeOperations[]

object (FeedAttributeOperation)

更改 Feed 属性的操作列表。只能添加属性，不能移除属性。
origin

enum (FeedOrigin)

不可变。指定谁负责管理该 Feed 的 FeedAttribute。
status

enum (FeedStatus)

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

string (int64 format)

仅限输出。Feed 的 ID。此字段为只读字段。
name

string

不可变。Feed 的名称。必填。
联合字段 system_feed_generation_data。Feed 的系统数据。此数据指定用于为系统生成的 Feed 生成 Feed 项的信息。system_feed_generation_data 只能是下列其中一项：
placesLocationFeedData

object (PlacesLocationFeedData)

用于配置从商家资料中填充的营业地点 Feed 的数据。
affiliateLocationFeedData

object (AffiliateLocationFeedData)

用于配置填充了指定连锁店的关联商户地址 Feed 的数据。

FeedAttribute

FeedAttributes 定义 Feed 中预期包含的数据类型。一个 FeedAttribute 可指定具有相同 FeedAttributeId 的 FeedItemAttribute 的预期类型。也可以将 FeedAttribute 标记为 FeedItem 的唯一键的一部分。

JSON 表示法 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
字段
type

enum (FeedAttributeType)

Feed 属性的数据类型。必填。
id

string (int64 format)

属性的 ID。
name

string

属性的名称。必填。
isPartOfKey

boolean

表示与该属性对应的数据是 FeedItem 唯一键的一部分。如果未指定，则默认为 false。请注意，Feed 架构中不需要唯一键，在这种情况下，FeedItem 必须通过其 feed_item_id 引用。

FeedAttributeType

Feed 属性可能的数据类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
INT64 Int64。
DOUBLE 双精度。
STRING String。
BOOLEAN 布尔值。
URL 网址。
DATE_TIME 日期时间。
INT64_LIST Int64 列表。
DOUBLE_LIST 双（8 个字节）列表。
STRING_LIST 字符串列表。
BOOLEAN_LIST 布尔值列表。
URL_LIST 网址列表。
DATE_TIME_LIST 日期时间列表。
PRICE 价格。

FeedAttributeOperation

要针对 mutate 中的 Feed 属性列表执行的操作。

JSON 表示法 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
字段
operator

enum (Operator)

仅限输出。要执行的列表操作类型。
value

object (FeedAttribute)

仅限输出。要添加到列表中的 Feed 属性。

运算符

运算符。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ADD 将该属性添加到现有属性中。

FeedOrigin

Feed 来源的可能值。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
USER 此 Feed 的 FeedAttribute 由用户管理。用户可以向此 Feed 添加 FeedAttribute。
GOOGLE GOOGLE 供稿的 FeedAttribute 由 Google 创建。此类型的 Feed 由 Google 维护，并具备该 Feed 占位符类型的正确属性。

FeedStatus

Feed 的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 信息流已启用。
REMOVED Feed 已被移除。

PlacesLocationFeedData

用于配置从商家资料中填充的营业地点 Feed 的数据。

JSON 表示法 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
字段
oauthInfo

object (OAuthInfo)

不可变。电子邮件所需的身份验证令牌（来自 OAuth API）。此字段只能在创建请求中指定。它的所有子字段均不可选择。
businessAccountId

string

应使用其营业地点的受管商家的 Google+ 信息页 ID。如果未设置此字段，则使用用户可以访问的所有商家（通过 emailAddress 指定）。此字段只能执行 mutate 操作，不可选择。
categoryFilters[]

string

用于按类别过滤商家资料中的商家信息。如果类别过滤器中存在条目，则只有属于任何类别的商家信息才有资格同步到 FeedItem。如果 categoryFilters 中不存在任何条目，则所有商家信息均应同步。
labelFilters[]

string

用于按标签过滤商家资料中的商家信息。如果标签过滤器中存在条目，则只有包含任何标签集的商家信息才是要同步到 FeedItems 的候选内容。如果 labelFilters 中没有条目，则所有商家信息都待同步。
emailAddress

string

商家资料的电子邮件地址或商家资料管理员的电子邮件地址。必填。
businessNameFilter

string

用于按商家名称过滤商家资料中的商家信息。如果设置了 businessNameFilter，则只有具有匹配的商家名称的商家信息才可以同步到 FeedItem。

OAuthInfo

用于通过 OAuth 进行授权的数据。

JSON 表示法 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
字段
httpMethod

string

用于获得授权的 HTTP 方法。
httpRequestUrl

string

用于获得授权的 HTTP 请求网址。
httpAuthorizationHeader

string

用于获得授权的 HTTP 授权标头。

AffiliateLocationFeedData

用于配置填充了指定连锁店的关联商户地址 Feed 的数据。

JSON 表示法 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
字段
chainIds[]

string (int64 format)

关联商户地址 Feed 将从中同步营业地点的连锁店列表。
relationshipType

enum (AffiliateLocationFeedRelationshipType)

连锁店与广告客户的关系。

AffiliateLocationFeedRelationshipType

关联商户地址 Feed 中关系类型的可能值。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
GENERAL_RETAILER 一般零售商关系。