Products API

概览

商家可以利用 Products API 创建网店商品目录,列出在 Google 购物上提供的商品和优惠。创建商家中心帐号后,商家可以使用 Products API,并准备通过 API 上传初始商品集。

Products API 可以将商品信息上传到购物 Merchant Center 数据库。它还提供一些方法,允许商家一次访问、更新或删除一件商品的信息,或以批处理模式一次访问、更新或删除多件商品的信息。

虽然商家可以使用名为主要 Feed 的文件加载商品,但使用 Content API 创建、更新和删除商品有很多优势,包括响应时间更快、能够实时更新多件商品的数据、无需管理多个补充 Feed。请注意,对于通过 API 调用所做的商品更改,可能需要几个小时之后才能在购物 Merchant Center 数据库中看到。

术语“商品”是指要展示在商家的商品详情页面上的有形物品,用于在 Google 购物等在线位置列出。

商品 ID

Shopping Content API 中使用了两种不同的商品 ID。

第一种 ID 名为 offerId,由商家分配给商品。此 ID 由表示特定优惠的字符串组成。对于 Shopping Merchant Center 数据库中的一系列优惠来说,offerId 是唯一的,通常是一个数字序列号。它还可以表示商家分配给商品的内部 SKU 编号。

第二种 ID 由 Google 分配给商品,称为 REST ID。REST ID 唯一标识商品,是一种采用格式 online:en:US:1111111111 的集合,并且将 offerId 添加为最后的组件。此 ID 往往用作 API 调用中的 productId。REST ID 由 4 个部分组成,用英文冒号分隔:

  1. 渠道(“在线”或“本地”)
  2. 内容语言(使用 2 个字母表示,例如“en”或“fr”)
  3. 目标国家/地区(使用 2 个字母表示,例如“US”或“FR”)
  4. 优惠 ID

这表示为 channel:contentLanguage:targetCountry:offerId(例如 online:en:US:1111111111),如下表所示:

属性 说明 示例 备注
id 通用 ID。 online:en:US:6 用在商品的 JSON 正文内部,以引用 productId
offerId 商品 ID 的另一个名称。 6 字符串数据类型,商品优惠的唯一标识符。
REST ID 由渠道、语言、国家/地区和优惠 ID 组成的复合字符串。 online:en:US:6 productId 配合使用的复合 ID。
productId REST ID 字符串。 online:en:US:6 这是一个 REST ID。

Products API

Products API 可以帮助您灵活管理 60 多个商品属性。这些属性统称为商品资源。有一些字段是必填字段,如果缺少这些字段,商品将不能获准在 Google 购物上展示。根据商家的位置、商品类型、使用的商品款式和捆绑商品等不同的使用情况,有一些可选字段可能会变成必填字段。有关可以为商品配置的 60 多个可选参数的详情,请参阅商品数据规范

利用 Products API,我们可以在 Merchant Center 数据库中,一次对一件商品执行 insertgetdelete 操作,也可以对所有商品执行 list 操作。

productstatuses API 可用于查看特定商品在平台上的批准或未获批准状态。有关哪些商品可能存在数据质量问题以及可能存在哪些问题的详情,请参阅 Product Statuses API 指南

在我们的 API 示例中,我们将使用三件商品,即两件 Google T 恤和一顶 Google 帽子。我们使用最小的商品数据集(如下表所示)来执行 Products API 调用,以插入、获取、列出和删除单件商品和整批商品。

最佳做法:我们建议在 Merchant Center 中,而不是在商品级别配置运费和税费信息。

id [ID] online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId [优惠 ID] 1111111111 2222222222 3333333333
title [商品名] 黑色 Google T 恤 绿色 Google T 恤 Google 斜纹帽
description [说明] 黑色 Google T 恤 100% 纯棉 Google T 恤 经典 Google 帽
item group ID [商品组 ID] google_tee google_tee
link [链接] http://my.site.com/blacktee http://my.site.com/greentee http://my.site.com/blackhat
condition [使用情况]
price [价格] 21.99 USD 21.99 USD 10.99 USD
availability [库存状况] 有货 有货 有货
imageLink [图片链接] https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin [GTIN] 9504000059422 9504000059446 9504000059452
mpn [MPN] 00638NIC 00638ANG 00638ABC
brand [品牌] Google Google Google
Google product category [Google 商品类别] 服饰与配饰 > 服饰 服饰与配饰 > 服饰 服饰与配饰 > 服装配饰 > 帽子
color [颜色] 黑色 绿色 黑色
size [尺寸] 大号 中号 中号
age_group [年龄段] 成人 成人 成人
gender [适用性别] 男性 男性 男女通用
included_destination [允许展示地点] Shopping Actions,购物广告 Shopping Actions,购物广告 Shopping Actions

Products.Insert

要插入单件商品,请使用以下请求网址(指定商家 ID)和示例 JSON 正文。插入操作将创建一件新商品。如果指定商品的属性 channelcontentLanguageofferIdtargetCountry 已经具有值,则此方法会更新该条目,并替换来自指定商品的先前 API 调用的所有数据。

显示的示例会向可用的商品中插入新的“黑色 Google T 恤”。

POST https://www.googleapis.com/content/v2/{merchantId}/products

调用 products.insert 的请求正文示例:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

商品还可在 JSON 正文内设置自定义属性。例如,我们可以为单件商品设置 purchase_quantity_limit,以限制客户可以订购的商品数量,如下所示:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "type": "int",
   "value": "4"
 }
]

请注意,purchase_quantity_limit 自定义属性会将每个客户订单的购买上限设置为商品定义,并且 Feed 也支持该属性。该属性目前处于测试阶段,直到获得 API 的完全支持为止。商家可以添加任何其他自定义属性,但是 API 不会进行任何特定处理。

调用成功后,将返回 HTTP 200 代码和包含商品资源的响应正文,如下所示:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ],
 "destinations": [
  {
   "destinationName": "Shopping",
   "intention": "required"
  }
 ]
}

Products.Get

要获取有关 Merchant Center 数据库中特定商品的信息,请使用 products.get。可能需要几分钟时间才能通过 products.get API 调用获得新插入的商品。

使用以下 HTTP 请求网址和参数、商家 ID 以及要获取的商品的 ID(REST ID 格式):

GET https://www.googleapis.com/content/v2/{merchantId}/products/{productId}

调用成功后,将返回 HTTP 200 并且在响应正文中返回“商品资源”。例如,我们的示例成功返回了以下信息(商品 ID 为 online:en:US:1111111111):

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ],
 "destinations": [
  {
   "destinationName": "Shopping",
   "intention": "required"
  }
 ]
}

Products.Delete

要删除单件商品,请将 products.delete 与示例 HTTP 请求网址、商家 ID,以及您要删除的商品的 ID(REST ID 格式,例如 online:en:US:1111111111)配合使用:

DELETE https://www.googleapis.com/content/v2/{merchantId}/products/{productId}

成功的响应将是 HTTP Status 204,表示成功但没有响应正文。

Products.List

products.list 将列出商家在商家中心数据库中拥有的所有商品。请使用以下请求网址:

GET https://www.googleapis.com/content/v2/{merchantId}/products

HTTP 200 成功消息与响应正文一起返回,其中 JSON 正文中的商品资源表示单件商品的数据。

系统会返回以下三件示例商品:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ],
   "destinations": [
    {
     "destinationName": "Shopping",
     "intention": "required"
    }
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
   Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ],
   "destinations": [
    {
     "destinationName": "Shopping",
     "intention": "required"
    }
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
   Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ],
   "destinations": [
    {
     "destinationName": "Shopping",
     "intention": "required"
    }
   ]
  }
 ]
}

批处理模式

利用 custombatch API 方法,商家可以使用单个 API 调用,一次性对多件商品执行 insertgetdelete 操作,优势是可以最大程度地减少执行 API 调用的次数。

使用以下请求网址来调用自定义批处理 API:

POST https://www.googleapis.com/content/v2/products/batch

请求正文包含特定参数:batchIdmerchantIDmethod

如果您正在执行 get 或 delete,则只能使用 productId。对 custombatch 执行 insert API 调用时不需要 productId

Custombatch:Insert

以下请求网址用于执行 products.custombatch method=insert

POST https://www.googleapis.com/content/v2/products/batch

为了插入两件新商品,我们指定此 API 调用中每件商品独有的 batchId、获授权执行此 API 调用的商家的 merchantId、此次处理的方法 (insert)。

在下面的示例中,batchId 分别为 11111112,并且是此特定 API 调用中每件商品的唯一标识符。merchantId: 1234567 应该是获得授权可执行 API 调用的商家,方法是 getdeleteinsert

insert 将创建一件新商品。如果指定商品的属性 channelcontentLanguageofferIdtargetCountry 已经具有值,则此方法更新该条目,并替换指定商品的先前 API 调用中的所有数据。

在以下 JSON 正文中,我们使用单个 API 调用向 Merchant Center 数据库中插入两件 T 恤:

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "product": {
        "kind": "content#product",
        "offerId": "1111111111",
        "source": "api",
        "title": "Google Tee Black",
        "description": "The Black Google Tee is available in unisex sizing and
        features a retail fit.",
        "link": "http://my.site.com/blacktee/",
        "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
        "contentLanguage": "en",
        "targetCountry": "US",
        "channel": "online",
        "ageGroup": "adult",
        "availability": "in stock",
        "availabilityDate": "2019-01-25T13:00:00-08:00",
        "brand": "Google",
        "color": "black",
        "condition": "new",
        "gender": "male",
        "googleProductCategory": "1604",
        "gtin": "608802531656",
        "itemGroupId": "google_tee",
        "mpn": "608802531656",
        "price": {
          "value": "21.99",
          "currency": "USD"
        },
        "sizes": [
          "Large"
        ],
        "destinations": [
          {
            "destinationName": "Shopping",
            "intention": "required"
          }
        ]
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "product": {
        "kind": "content#product",
        "offerId": "2222222222",
        "source": "api",
        "title": "Google Tee Green",
        "description": "100% cotton jersey fabric sets  this Google t-shirt above
        the crowd. Features the google logo across the chest. Unisex sizing.",
        "link": "http://my.site.com/greentee/",
        "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
        "contentLanguage": "en",
        "targetCountry": "US",
        "channel": "online",
        "ageGroup": "adult",
        "availability": "in stock",
        "availabilityDate": "2019-01-25T13:00:00-08:00",
        "brand": "Google",
        "color": "green",
        "condition": "new",
        "gender": "male",
        "googleProductCategory": "1604",
        "gtin": "608802531649",
        "itemGroupId": "google_tee",
        "mpn": "608802531649",
        "price": {
          "value": "21.99",
          "currency": "USD"
        },
        "sizes": [
          "Medium"
        ],
        "destinations": [
          {
            "destinationName": "Shopping",
            "intention": "required"
          }
        ]
      }
    }
  ]
}

API 调用成功后,将返回 HTTP 200 代码和包含刚插入的商品的响应 JSON。返回 JSON 的格式类似于以下内容:

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1111,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Tee Black",
    "description": "The Black Google Tee is available in unisex sizing and
    features a retail fit.",
    "link": "http://my.site.com/blacktee/",
    "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
    "contentLanguage": "en",
    "targetCountry": "US",
    "channel": "online",
    "ageGroup": "adult",
    "availability": "in stock",
    "availabilityDate": "2019-01-25T13:00:00-08:00",
    "brand": "Google",
    "color": "black",
    "condition": "new",
    "gender": "male",
    "googleProductCategory": "1604",
    "gtin": "608802531656",
    "itemGroupId": "google_tee",
    "mpn": "608802531656",
    "price": {
     "value": "21.99",
     "currency": "USD"
    },
    "sizes": [
     "Large"
    ],
    "destinations": [
     {
      "destinationName": "Shopping",
      "intention": "required"
     }
    ]
   }
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1112,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:2222222222",
    "offerId": "2222222222",
    "title": "Google Tee Green",
    "description": "100% cotton jersey fabric sets this Google t-shirt above
    the crowd. Features the google logo across the chest. Unisex sizing.",
    "link": "http://my.site.com/greentee/",
    "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
    "contentLanguage": "en",
    "targetCountry": "US",
    "channel": "online",
    "ageGroup": "adult",
    "availability": "in stock",
    "availabilityDate": "2019-01-25T13:00:00-08:00",
    "brand": "Google",
    "color": "green",
    "condition": "new",
    "gender": "male",
    "googleProductCategory": "1604",
    "gtin": "608802531649",
    "itemGroupId": "google_tee",
    "mpn": "608802531649",
    "price": {
     "value": "21.99",
     "currency": "USD"
    },
    "sizes": [
     "Medium"
    ],
    "destinations": [
     {
      "destinationName": "Shopping",
      "intention": "required"
     }
    ]
   }
  }
 ]
}

Custombatch:Get

以下请求网址用于使用 method=get 执行 products.custombatch

POST https://www.googleapis.com/content/v2/products/batch

为了获得商品,我们指定此 API 调用中商品独有的 batchId、获授权执行此 API 调用的商家的 merchantId、此次处理的方法 (get) 以及被检索的商品的 productId

以下是一个示例 JSON 请求正文,用于检索我们使用 custombatch:insert 调用插入的两件商品(由 productId 所指定)。batchId 对于列表中的每件商品都是独有的:

{
  "entries": [
    {
      "batchId": 1113,
      "merchantId": 1234567,
      "method": "get",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1114,
      "merchantId": 1234567,
      "method": "get",
      "productId": "online:en:US:2222222222"
    }
  ]
}

成功的 HTTP 200 代码与以下响应正文一起返回:

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1113,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "source": "api",
    "title": "Google Tee Black",
    "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
    "link": "http://my.site.com/blacktee/",
    "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
    "contentLanguage": "en",
    "targetCountry": "US",
    "channel": "online",
    "ageGroup": "adult",
    "availability": "in stock",
    "availabilityDate": "2019-01-25T13:00:00-08:00",
    "brand": "Google",
    "color": "black",
    "condition": "new",
    "gender": "male",
    "googleProductCategory": "1604",
    "gtin": "608802531656",
    "itemGroupId": "google_tee",
    "mpn": "608802531656",
    "price": {
     "value": "21.99",
     "currency": "USD"
    },
    "sizes": [
     "Large"
    ],
    "destinations": [
     {
      "destinationName": "Shopping",
      "intention": "required"
     }
    ]
   }
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1114,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:2222222222",
    "offerId": "2222222222",
    "source": "api",
    "title": "Google Tee Green",
    "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
    "link": "http://my.site.com/greentee/",
    "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
    "contentLanguage": "en",
    "targetCountry": "US",
    "channel": "online",
    "ageGroup": "adult",
    "availability": "in stock",
    "availabilityDate": "2019-01-25T13:00:00-08:00",
    "brand": "Google",
    "color": "green",
    "condition": "new",
    "gender": "male",
    "googleProductCategory": "1604",
    "gtin": "608802531649",
    "itemGroupId": "google_tee",
    "mpn": "608802531649",
    "price": {
     "value": "21.99",
     "currency": "USD"
    },
    "sizes": [
     "Medium"
    ],
    "destinations": [
     {
      "destinationName": "Shopping",
      "intention": "required"
     }
    ]
   }
  }
 ]
}

Custombatch:Delete

以下请求网址用于使用 method=delete 执行 products.custombatch

POST https://www.googleapis.com/content/v2/products/batch

为了删除商品,我们指定此 API 调用中商品独有的 batchId、获授权执行此 API 调用的商家的 merchantId、此次处理的方法 (delete) 以及被删除的商品的 productId

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "productId": "online:en:US:2222222222"
    }
  ]
}

成功的 HTTP 200 响应代码和响应正文会返回,指示已经从 Merchant Center 数据库中删除的商品的 batchId

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1115
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1116
  }
 ]
}

API 将 v2 更改为 v2.1

Product API getdeletelistinsert 方法有许多更改,并且 Product 资源从 v2 更改为 v2.1。有关这些更改的详请,请参阅 Content API v2 到 v2.1 迁移指南

测试 Products API

这些测试示例使用 base_url 来引用 https://www.googleapis.com。此外,所有示例都在生产环境中的网址中使用 /content/v2。为了测试 API v2.1,您可以用 /content/v2.1 替换。在此示例中,我们添加、查看、更新和删除商品。

Dry Run

  1. dryRun 查询参数设置为 true,并进行 products.insert 调用。

  2. 如果请求正文中存在错误,服务器将告知您错误的位置。

使用 products.insert 添加商品:

  1. 为商品构建有效的 JSON(或使用上述 products.insert 部分中的该条目)。

  2. 对 API 端点执行 INSERT,如下所示:

    INSERT https://www.googleapis.com/content/v2/merchantId/products
    
  3. 使用您自己的商家 ID 和商品 JSON。

  4. 您应该会收到 HTTP 200 状态代码(表示成功)和原始 JSON。

使用 products.get 查看商品:

  1. 对 API 端点执行 GET,如下所示:

    GET https://www.googleapis.com/content/v2/merchantId/products/productId
    
  2. 使用您自己的商家 ID 和商品 ID (Rest ID)。要获取上一步中插入的商品,请使用商品 ID online:en:US:1111111111

  3. 对于已提交的商品 ID,您应该会收到 HTTP 200 状态代码(表示成功)和 JSON。

使用 products.insert 更新商品

  1. 为商品构建有效的 JSON(修改上述 products.insert 部分中的该条目)。使用您自己的商家 ID。例如,对于以上 product.insert 部分中的商品 ID online:en:US:1111111111,您可以将 JSON availability: in stock 中的单个字段更改为 out of stock

  2. 对 API 端点执行 INSERT,如下所示:

    INSERT https://www.googleapis.com/content/v2/merchantId/products
    
  3. 您应该会收到 HTTP 200 状态代码(表示成功)以及所提交的商品 ID 的 JSON(含更新的值 availability: out of stock)。

删除商品

  1. 使用您自己的商家 ID 和商品 ID (Rest ID),例如:online:en:US:111111111

  2. 对 API 端点执行 DELETE,如下所示:

    DELETE https://www.googleapis.com/content/v2/merchantId/products/productId
    
  3. 在 API 调用成功的情况下,您应该会收到 HTTP 204 状态代码。