REST Resource: accounts.productInputs

资源：ProductInput

此资源代表您为商品提交的输入数据，而不是您在 Merchant Center、购物广告或 Google 各平台上看到的经过处理的商品。系统会将商品输入、规则和补充数据源数据组合起来，以创建经过处理的 Product。

商品数据规范主要定义了必须提供的商品输入属性，以便通过数据验证检查。

以下属性是必需的：feedLabel、contentLanguage 和 offerId。

插入、更新或删除商品输入后，可能需要几分钟才能检索到处理后的商品。

商品输入及其子消息中的所有字段都与相应行业规范中相应属性的英语名称一致，但有少数例外情况。

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

string

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

string

仅限输出。处理的商品的名称。格式："{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

必需。不可变。商品的渠道。
offerId

string

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

string

必需。不可变。商品的双字母 ISO 639-1 语言代码。
feedLabel

string

必需。不可变。商品的 Feed 标签。
attributes

object (Attributes)

可选。商品属性列表。
customAttributes[]

object (CustomAttribute)

可选。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。每个自定义属性允许的字符数上限为 10240 个（表示名称和值的字符数总和）。每个商品最多可设置 2, 500 个自定义属性，总大小不得超过 102.4KB。自定义属性名称中的下划线会在插入时替换为空格。
versionNumber

string (int64 format)

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

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

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

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

方法

delete

 从 Merchant Center 账号中删除商品输入信息。

insert

 将商品输入内容上传到您的 Merchant Center 账号。