本指南介绍了如何与通用商务协议 (UCP) 购物车 API 集成,以便用户在 Google 界面(包括 Google 搜索中的 AI 模式和 Gemini)中构建和管理购物车。此功能旨在让用户在明确表示要结账之前构建购物车。
概览
借助 UCP 购物车 API(功能名称:
dev.ucp.shopping.cart
),您可以将用户的购物车从 Google 界面(例如
Google 搜索中的 AI 模式和 Gemini)直接转移到您的网站。此 API 支持 Google 的通用购物车功能,允许通过 CreateCart
端点在您的系统上单向填充购物车。此 API 不同于
结账 API,因为它
不
处理付款或完整的购买生命周期。
实现 CreateCart 的主要优势:
- 对于用户: 从 Google 上的商品发现到您网站上预先填充的购物车,实现无缝过渡。
- 对于商家: 直接从 Google 接收用户购物车,简化客户的初始购买步骤,并提供在您的网站上追加销售和交叉销售的机会。
前提条件
- 确保您的系统已设置为处理 UCP 版本
2026-04-08。 - 按照 UCP 资料
指南中的说明,在
/.well-known/ucp中发布您的 UCP 资料,并添加dev.ucp.shopping.cart功能。您在资料中指定的endpoint(例如https://business.example.com/ucp/v1)将用作这些 API 调用的基础网址。
身份验证
如需详细了解如何保护购物车 API 端点(包括受支持的 身份验证方法,例如 API 密钥和 OAuth 2.0),请参阅身份验证和 安全性指南。
后续步骤
查看 UCP 购物车 API 的 API 载荷和技术实现详情: