Cart API

Ce guide explique comment intégrer Cart API pour Universal Commerce Protocol (UCP) pour permettre aux utilisateurs de créer et de gérer un panier sur les surfaces Google, y compris le Mode IA dans la recherche Google et Gemini. Cette capacité est conçue pour la création de paniers avant que l'utilisateur n'ait exprimé l'intention explicite de passer au paiement.

Présentation

Cart API pour UCP (nom de la capacité : dev.ucp.shopping.cart) permet de transférer le panier d'un utilisateur depuis les surfaces Google, comme le Mode IA dans la recherche Google et Gemini, directement vers votre site Web. Cette API est compatible avec la fonctionnalité Panier universel de Google en permettant de remplir le panier de manière unidirectionnelle sur votre système, principalement grâce au point de terminaison CreateCart.

Cette version initiale est limitée à la création et au transfert de paniers à l'aide de la méthode CreateCart. Les fonctionnalités telles que la mise à jour, la suppression ou la synchronisation du contenu du panier entre Google et votre système ne sont pas prises en charge.

Principaux avantages

Principaux avantages de l'implémentation de CreateCart :

  • Pour les utilisateurs : une transition fluide entre la découverte de produits sur Google et un panier prérempli sur votre site Web.
  • Pour les marchands : recevez les paniers des utilisateurs directement depuis Google. Cela simplifie le parcours d'achat initial de vos clients et vous permet de proposer des ventes incitatives ou croisées sur votre site Web.

Conditions préalables

  • Assurez-vous que votre système est configuré pour gérer la version 2026-04-08 de l'UCP.
  • Publiez votre profil UCP sur /.well-known/ucp et incluez la fonctionnalité dev.ucp.shopping.cart, comme décrit dans le guide du profil UCP. Le endpoint spécifié dans votre profil (par exemple, https://business.example.com/ucp/v1) sera utilisé comme URL de base pour ces appels d'API.

Authentification

Pour en savoir plus sur la sécurisation des points de terminaison de Cart API, y compris sur les méthodes d'authentification compatibles telles que les clés API et OAuth 2.0, consultez le guide Authentification et sécurité.

Étapes suivantes

Consultez les charges utiles de l'API et les détails techniques d'implémentation de Cart API pour UCP :