Method: accounts.productInputs.insert

将商品信息上传到您的 Merchant Center 账号。如果已存在具有相同 contentLanguage、offerId 和 dataSource 的输入，此方法将替换该条目。

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

HTTP 请求

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。将在其中插入此商品的账号。格式：accounts/{account}

查询参数

参数
dataSource

string

必需。主要或补充商品数据源名称。如果商品已存在且提供的数据源不同，则系统会将相应商品移至新的数据源。格式：accounts/{account}/dataSources/{datasource}。

请求正文

请求正文包含一个 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 个（表示名称和值的字符数总和）。每个产品最多可以设置 2500 个自定义属性，总大小为 102.4kB。自定义属性名称中的下划线会在插入时替换为空格。
versionNumber

string (int64 format)

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

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

仅支持插入主要数据源。

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

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/content

如需了解详情，请参阅 OAuth 2.0 概览。