“在 Google 上购买”弃用

以下是适用于 Google 搜索和 Google 购物的“在 Google 上购买”的弃用时间表。在此日期之后，这些功能将不再可用。

2023 年 6 月 28 日：

• buyongoogleprograms.requestreview
• buyongoogleprograms.onboard
• buyongoogleprograms.activate
• buyongoogleprograms.pause

2023 年 9 月 30 日：

• buyongoogleprograms.get
• buyongoogleprograms.patch

2023 年 10 月 31 日：

• 除 list 和 get 以外的所有 orders 功能
• orderinvoices
• orderreports
• orderreturns

2024 年 10 月 31 日：

• orders.list
• orders.get

开始使用

借助 orders 资源，商家可以处理通过“在 Google 上购买”收到的订单。

您可以使用 orders 资源执行以下操作：

• 接收并确认新订单。
• 更新订单状态。
• 管理退货。
• 提供退款。

下面总结了 orders 资源的使用方式：

在“在 Google 上购买”计划中注册您的 Merchant Center 帐号

这是对您的 Merchant Center 注册的补充。请与我们联系，确保您的 Google 帐号已注册。

同意“在 Google 上购买”条款

这些信息位于初始配置阶段的 Merchant Center > Google 易购下，也可位于简介子菜单下。

配置新项目

下载 JSON 服务帐号密钥，您可能需要按照服务帐号密钥中的说明进行修改。

如需了解详情，请参阅配置 Google 控制台项目。

分配“在 Google 上购买”订单管理员角色

请参阅分配 Order Manager 角色。将此电子邮件地址添加到您在上一步中创建的 Google 服务帐号 (GSA)。请对需要使用 orders 资源或访问 Merchant Center 中的“订单”视图的任何其他帐号执行此操作。

（可选）下载适合您的应用的 Content API 客户端库

修改 API 密钥

仅通过网络服务拨打电话，而非使用库时，才需要执行此操作。请参阅服务帐号密钥。

实现 OAuth 2.0 身份验证

请参阅为请求授权。或者，如获取访问令牌中所述，您可以获取要包含在 RESTful 请求的访问令牌。

调用 orders 资源

如需了解详情，请参阅使用订单资源，或参阅此简短教程来试用资源。先使用沙盒模式测试 orders 资源实现，然后再将其部署到生产环境。

分配 Order Manager 角色

您必须先向 Google 服务帐号 (GSA) 以及需要访问 orders 资源或 Merchant Center 中的订单视图的任何其他帐号分配“在 Google 上购买订单管理员”角色，然后才能使用 orders 资源。

分配 Order Manager 角色的方法如下：

1. 打开 Merchant Center。
2. 点击右上角的扳手图标，然后选择帐号访问权限：

   

   Merchant Center 会显示用户及其角色的列表。

   如果您在下拉列表中没有看到帐号访问权限，则说明您的帐号没有管理员权限。

3. 点击相应用户所在的行以进行修改。

   系统会显示“用户偏好设置”视图。

   如果帐号不在用户列表中，请点击 + 添加该帐号。

4. 在用户访问权限部分，勾选 Order Manager 复选框：

   

5. 点击保存以保存更改。

“在 Google 上购买”订单管理员角色应显示在用户列表中的用户旁边。对将访问 orders 资源或 Merchant Center 中的“订单”视图的所有帐号重复此过程。

沙盒模式和生产模式

您可以通过两种模式使用 orders 资源：

沙盒模式

在沙盒中构建和测试您的实现。有时，我们会先在这里推出新功能。

生产模式

在生产环境中部署实现。

您可以在网址中指明要使用的版本：

https://www.googleapis.com/content/mode/merchant_ID/orders/

其中，merchant_ID 是您的 Merchant Center ID，mode 用于指定使用哪种模式：

沙盒模式 (v2.1sandbox)

如需实验和发出测试请求，请通过为网址中的 mode 指定 v2.1sandbox 来使用沙盒模式。例如：

      GET 'https://www.googleapis.com/content/v2.1sandbox/42/orders/'
      

沙盒模式还支持生产环境模式所不支持的下列方法：

• createtestorder
• advancetestorder
• gettestordertemplate

生产模式 (v2.1)

通过在网址中为 mode 指定 v2.1，使用生产模式进行实时订单处理。例如：

 GET 'https://www.googleapis.com/content/v2.1/42/orders/'
      

使用试用此 API

如需在沙盒模式下创建测试订单，请使用 createtestorder 页面右侧的试用此 API 框。试用 API 适用于所有 API 文档页面。

若要通过试用此 API 来创建测试订单，请执行以下操作：

1. 打开 API 参考文档 > createtestorder 页面。

   请注意，试用此 API 会调用您当前查看的网页的方法。例如，如果您正在查看 createtestorder 参考页面，试用此 API 会调用 createtestorder。如需调用 get，请转到 get 参考页面。

2. 在 merchantId 请求参数字段中输入您的商家 ID。
3. 将 templateName 字段添加到请求正文，并将其设置为下述模板之一，例如 template1。

   以下示例展示了使用商家 ID 42 的调用：

   

4. 点击执行。

   orders 资源会创建一个新的测试订单，并返回 HTTP 200 作为响应。响应中会包含新建订单的订单 ID：

   

5. 从响应中复制 orderId。您在后续步骤中会用到此 ID。

后续步骤

创建测试订单后，您可以完成订单流程，并在每一步更新订单状态：

1. 使用 get 方法查看新建订单的内容。
2. 使用 list 方法获取您的帐号下所有订单的列表。
3. 通过advancetestorder将您的订单状态提前至pendingShipment。
4. 使用 acknowledge 确认订单。
5. （可选）使用 updatemerchantorderid 分配商家订单 ID。
6. 通过 shiplineitems 创建运单并将订单状态更改为“shipped”。
7. （可选）在订单发货前，使用 captureOrder 向客户收费。
8. 将订单的运单状态设置为“delivered”（对于“updateshipment”）。

如需了解详情，请参阅使用订单资源。

订单模板

Google 提供了以下订单模板：

• template1：两个商品/SKU，数量为 2 和 1，无促销活动
• template1a：两个商品/SKU，数量为 2 和 1，无促销活动
• template1b：两种商品/SKU，数量为 2 和 1，特定商品促销活动
• template2：一件商品/SKU，数量为 2 个，无促销活动
• template3：一件商品/SKU，数量为 2 个，无促销活动，自提点（仅限法国）

您可以在 createtestorder 方法中使用 templateName 形参设置模板。

orders 资源支持发送包含不同数量多种商品/SKU 的订单。

您可以使用您的商家 ID 和要查看的模板的名称调用 gettestordertemplate，以查看模板的格式。