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][google.shopping.content.bundles.Products.Product]。

通过数据验证检查所必需的商品输入属性主要在商品数据规范中进行了定义。

以下属性是必需属性:[feedLabel][google.shopping.content.bundles.Products.feed_label]、[contentLanguage][google.shopping.content.bundles.Products.content_language] 和 [offerId][google.shopping.content.bundles.Products.offer_id]。

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

商品输入及其子消息中的所有字段均与行业规范中相应属性的英文名称相匹配,但有一些例外情况

如果成功,响应正文将包含结构如下的数据:

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}}"

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 概览