購物車 API

本指南說明如何整合通用商務通訊協定 (UCP) 購物車 API,讓使用者在 Google 平台 (包括 Google 搜尋的 AI 模式和 Gemini) 建構及管理購物車。這項功能旨在讓使用者在明確表示要結帳前,先建立購物車。

總覽

UCP 購物車 API (功能名稱: dev.ucp.shopping.cart ) 可將使用者的購物車從 Google 服務 (例如 Google 搜尋的 AI 模式和 Gemini) 直接轉移至你的網站。這個 API 支援 Google 的全域購物車功能,可單向填入系統中的購物車,主要透過 CreateCart 端點進行。這個 API 與結帳 API 不同,因為這個 API「不會」處理付款或完整的購買生命週期。

導入 CreateCart 的主要優點:

  • 對使用者:從 Google 探索產品到網站上預先填入的購物車,整個過程流暢無阻。
  • 商家:直接從 Google 接收使用者購物車,簡化顧客的初始購買步驟,並提供在網站上追加銷售和交叉銷售的機會。

必要條件

  • 確認系統已設定為處理 UCP 版本 2026-04-08。
  • 在 /.well-known/ucp 發布 UCP 設定檔,並加入 dev.ucp.shopping.cart 功能,詳情請參閱 UCP 設定檔指南。您設定檔中指定的 endpoint (例如 https://business.example.com/ucp/v1) 會做為這些 API 呼叫的基本網址。

驗證

如要進一步瞭解如何保護購物車 API 端點,包括支援的驗證方法 (例如 API 金鑰和 OAuth 2.0),請參閱「驗證與安全性」指南。

後續步驟

查看 UCP 購物車 API 的 API 酬載和技術實作詳細資料: