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 的属性。在 CREATE 时为必需，除非提供了 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

FeedAttribute 定义 Feed 中应包含的数据类型。一个 FeedAttribute 指定具有相同 FeedAttributeId 的 FeedItemAttributes 的预期类型。您也可以将 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 Feed 的 FeedAttributes 由 Google 创建。此类型的 Feed 由 Google 维护，并具有该 Feed 占位符类型的正确属性。

FeedStatus

Feed 的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED Feed 已启用。
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）。此字段是仅可变字段，且不可选择。
categoryFilters[]

string

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

string

用于按标签过滤商家资料中的商家信息。如果 labelFilters 中存在条目，则只有设置了任意标签的列表才是同步到 FeedItem 的候选条目。如果 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 一般零售商关系。