Cart API

本指南介绍了如何与通用商务协议 (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 载荷和技术实现详情: