本页面列出了一组 Google Retail API 交互式教程，其中包含可以在 Google Cloud Shell Editor 中运行的操作。借助此工具，您可以直接在浏览器中编写、构建、测试、运行和调试云原生应用。
概览
根据您想要学习的内容，尝试不同的教程：
如果您要开始一个项目，请尝试学习导入清单信息教程。在这里，您将学习如何将商品导入清单中，以便体验不同的功能。接下来，请参阅导入历史用户事件教程。Retail API 使用用户事件生成初始推荐内容和搜索结果。然后，您可以学习录制实时用户事件教程。Retail API 使用实时用户事件来提供优质且相关的结果。
如果您对 Google 搜索的一般工作原理感兴趣，请尝试学习搜索教程。
如果您想了解如何使用服务配置和控件来配置搜索，请尝试学习以下教程：
如果您需要更新清单信息，请参阅管理目录信息教程。
如果您想了解如何更新商品目录，请参阅更新 Retail Search 的商品目录教程。
如果您想要了解如何记录、查看或移除实时用户事件，请参阅记录实时用户事件教程。
如果您计划使用 Recommendations AI，请参阅有关导入和管理目录和用户事件的教程。
导入清单信息
这些教程介绍了如何将清单信息导入 Retail API 并使其保持最新状态。
从 BigQuery 导入目录数据
本教程介绍如何使用 BigQuery 表无限制地导入大量清单数据。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
从 Cloud Storage 导入清单数据
本教程介绍了如何将大量商品导入清单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
以内嵌方式导入清单数据
本教程介绍如何以内嵌方式将商品导入清单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
管理目录信息
这些教程介绍了如何在将清单导入 Retail API 后管理商品信息。您可以读取、写入和删除目录中的商品。
了解如何使用您所选的语言调用 Google Cloud Retail API。
教程：创建/获取/更新/删除商品
本教程介绍了如何使用 Retail API 商品服务方法，以便执行以下操作：
- 创建商品
- 获取商品
- 更新商品
- 删除商品
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：创建商品
本教程介绍了如何创建单件商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：获取商品
本教程介绍了如何检索商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：更新商品
本教程介绍如何更新目录中的商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：删除商品
本教程介绍如何从清单中删除商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
导入历史用户事件
这些教程介绍了如何批量导入过往事件的用户事件数据。Retail API 模型需要用户事件数据进行训练。
教程：从 Cloud Storage 导入事件
本教程介绍如何从 Cloud Storage 导入用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：从 BigQuery 导入事件
本教程介绍如何从 BigQuery 导入用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：导入事件内联
本教程介绍如何以内嵌方式导入用户事件数据。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
记录实时用户事件
这些教程介绍了如何记录、查看或移除实时用户事件。Retail API 使用实时用户事件来生成推荐内容和搜索结果。记录尽可能多的用户事件类型和有效的产品信息可以提高结果的质量。
教程：写入用户事件
本教程介绍如何使用 userEvents.write 方法记录用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：重新联接用户事件
本教程介绍如何通过向 userEvents:rejoin 端点发出 POST 请求来重新联接用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：移除用户事件
本教程介绍如何完全清除用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
搜索教程
Retail API 的 search() 方法用于根据搜索查询和其他参数（例如过滤条件、商品详情或 order_by）来搜索清单。
默认情况下，搜索响应包含按相关性排序的合理数量的结果。
教程：查询
本教程介绍了如何向 Retail 服务发送简单搜索查询并分析响应。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：分页
本教程介绍了如何在搜索请求中控制分页。买家在实体店中寻找商品后，可以通过搜索结果改善导航体验。例如，他们可以使用页面大小功能限制搜索响应中的项数，或使用偏移功能跳转到首选页面。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：查询扩展
本教程介绍了如何启用查询扩展功能。如果购物者使用含糊不清或多字词的搜索词组，他们可能会收到空的响应。启用查询扩展后，Retail Search 会分析请求，并根据解析后的搜索查询返回展开的商品列表。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：过滤
本教程演示了过滤功能。利用该功能，您可以根据自己或客户的需求对搜索请求进行微调。您可以按单个或多个字段进行过滤，也可以按文本字段和/或数字字段进行过滤。您可以使用表达式语言为每个字段构造谓词，也可以使用逻辑运算符组合不同的表达式。例如，寻找鞋子的购物者可以使用过滤条件缩小搜索范围，仅显示自己喜欢的品牌和颜色。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：排序
本教程介绍了如何在搜索响应中对商品进行排序。当买家在您的网站上查找商品时，Retail Search 可以显示按多个字段排序的结果。例如，一位买家正在搜索价格和折扣最高的连衣裙。价格和折扣是这里的多个字段。Retail Search 将显示按价格排序的连衣裙，并会按折扣价格显示价格相同的连衣裙。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：升位
本教程展示了一些商品在搜索结果中的排名提升示例。借助升位功能，您可以对商品应用升位功能，从而在搜索结果中确定商品的优先级或降低其优先级。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：重定向控件
本教程介绍了如何使用重定向控件。借助重定向控件，您可以指定当用户使用特定搜索查询时可以将他们重定向到哪个网址。例如，如果用户请求“可持续性制造产品”，您可以重定向到包含您合作的环境品牌的页面。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
为 Retail Search 更新商品目录
虽然使用 Product 创建、读取、更新和删除 (CRUD) 方法可广泛修改 Product 的属性，但有一组 Product 方法可用于用于更新具有不同粒度级别的商品目录特定字段。以下 Product 字段被视为商品目录字段：
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
教程：添加履单信息
本教程介绍如何使用 AddFulfillmentPlaces 方法更新商品履单信息。这样，Retail Search 便可以显示商品有货以及可以履行订单的最新动态。例如，一位购物者正在一家商店寻找蓝色牛仔裤，但该商品缺货。当牛仔裤在这个商店或任何其他商店有货时，Retail Search 会显示最新信息，并且买家可以继续处理订单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：移除履单
本教程介绍如何使用 [RemoveFulfillmentPlaces][remove-fulfillment-places] 方法更新商品履单信息。这样一来，Retail Search 就可以在商品缺货以及订单无法完成的情况下显示更新信息。例如，一位购物者正在实体店中寻找蓝色牛仔裤。如果此商店中的牛仔裤缺货，Retail Search 会显示相应更新，并且买家无法继续处理订单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：设置商品目录
本教程介绍如何使用 SetInventory 方法推送商品目录更新，而不是更新整个商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：