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.

Remarque : Cart API est une nouvelle fonctionnalité qui n'est disponible qu'à partir de la version 2026-04-08 d'UCP.

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.

Remarque : Le paiement natif est une API distincte qui n'est pas requise pour implémenter le transfert de panier. Les gestionnaires de paiement et les cycles de vie des commandes ne sont pas non plus requis pour la fonctionnalité de transfert de panier.

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 (clés API ou OAuth 2.0, par exemple), consultez le guide Authentification et sécurité.

Objectifs de niveau de service et planification de la capacité

Bien qu'aucun objectif de niveau de service (SLO) formel ne soit appliqué au point de terminaison POST /carts, nous vous recommandons vivement de respecter les objectifs suivants afin de garantir une expérience de transfert de panier fluide pour les utilisateurs :

• Latence : répondez le plus rapidement possible, idéalement en moins d'une seconde. Les réponses qui prennent plus d'une seconde n'entraînent pas l'échec du flux de transfert, mais une latence plus élevée peut dégrader l'expérience utilisateur.
• Planification de la capacité : planifiez la capacité de vos points de terminaison en fonction du trafic généré par les sites référents attendu pendant les pics de vos campagnes. Les appels POST /carts sont entièrement déclenchés par l'intention utilisateur (lorsqu'un utilisateur clique pour transférer son panier) et le volume de requêtes est basé sur le trafic utilisateur.
• Limitation du débit : limitez les requêtes de manière fluide en renvoyant des réponses HTTP 429 (Too Many Requests) standards si votre système reçoit un trafic qui dépasse ses limites de débit. Pour en savoir plus, consultez Codes d'erreur.

Étapes suivantes

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

• Cart API version 2026-04-08