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