REST Resource: accounts.products

资源：Product

处理后的产品，在应用规则和补充数据源后，从多个 product inputs 构建而成。经过处理的商品与您的 Merchant Center 账号以及购物广告和 Google 各个平台上的其他位置中显示的商品一致。每个商品都由一个主要数据源商品输入和多个补充数据源输入构建而成。插入、更新或删除商品输入后，可能需要几分钟时间才能检索到更新后的处理商品。

经过处理的商品及其子消息中的所有字段都与商品数据规范中相应属性的名称一致，但存在一些例外情况。

JSON 表示法 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
字段
name

string

产品的名称。格式："{product.name=accounts/{account}/products/{product}}"，其中最后一个部分 product 由 4 部分组成：channel~contentLanguage~feedLabel~offerId，商品名称示例为“accounts/123/products/online~en~US~sku123”
channel

enum (ChannelEnum)

仅限输出。商品的渠道。
offerId

string

仅限输出。商品的唯一标识符。商品输入和处理后的商品也是如此。提交后，系统会移除前导和尾随空格，并将多个空格替换为单个空格。如需了解详情，请参阅商品数据规范。
contentLanguage

string

仅限输出。商品的双字母 ISO 639-1 语言代码。
feedLabel

string

仅限输出。商品的 Feed 标签。
dataSource

string

仅限输出。商品的主要数据源。
attributes

object (Attributes)

仅限输出。商品属性列表。
customAttributes[]

object (CustomAttribute)

仅限输出。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。
productStatus

object (ProductStatus)

仅限输出。商品的状态、数据验证问题，即异步计算的商品相关信息。
versionNumber

string (int64 format)

仅限输出。表示商品的现有版本（新鲜度），可用于在同时进行多项更新时保持正确的顺序。

如果设置，则当版本号低于现有商品的当前版本号时，系统会阻止插入。可以使用当前的 versionNumber 执行重新插入（例如，在 30 天后刷新商品）。

仅支持向主要数据源插入数据。

如果操作被阻止，系统会抛出中止异常。

ProductStatus

商品的状态、数据验证问题，即异步计算的商品相关信息。

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
字段
destinationStatuses[]

object (DestinationStatus)

商品的预期目的地。
itemLevelIssues[]

object (ItemLevelIssue)

与商品关联的所有问题的列表。
creationDate

string (Timestamp format)

商品的创建日期，采用 ISO 8601 格式。
lastUpdateDate

string (Timestamp format)

商品的上次更新日期，采用 ISO 8601 格式。
googleExpirationDate

string (Timestamp format)

商品的到期日期，采用 ISO 8601 格式。

DestinationStatus

商品状态的目标状态。

JSON 表示法 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
字段
reportingContext

enum (ReportingContextEnum)

报告上下文的名称。
approvedCountries[]

string

优惠已获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
pendingCountries[]

string

优惠待批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
disapprovedCountries[]

string

优惠未获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

ItemLevelIssue

商品状态的 ItemLevelIssue。

JSON 表示法 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
字段
code

string

问题的错误代码。
severity

enum (Severity)

此问题对提供服务有何影响。
resolution

string

商家是否可以解决此问题。
attribute

string

属性的名称（如果此问题是由单个属性引发的）。
reportingContext

enum (ReportingContextEnum)

问题适用的报告上下文。
description

string

以英文编写的简短问题说明。
detail

string

以英文编写的详细问题说明。
documentation

string

帮助解决此问题的网页的网址。
applicableCountries[]

string

问题适用的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

严重程度

问题对商品投放有何影响。

枚举
SEVERITY_UNSPECIFIED 未指定。
NOT_IMPACTED 此问题属于警告性问题，不会对商品产生直接影响。
DEMOTED 商品被降级，在搜索结果中的展示效果很可能受限
DISAPPROVED 问题导致商品被拒批。

方法

get

 从您的 Merchant Center 账号检索已处理的产品。

list

 列出 Merchant Center 账号中已处理的商品。