API del carrito

En esta guía, se describe cómo realizar la integración con la API de Carrito del Protocolo de Comercio Universal (UCP), lo que permite a los usuarios compilar y administrar un carrito de compras en las plataformas de Google, incluido el Modo IA en la Búsqueda de Google y Gemini. Esta función está diseñada para la compilación de carritos antes de que el usuario haya expresado una intención explícita de confirmar la compra.

Nota: Esta API de Carrito es una función nueva y solo está disponible a partir de la versión 2026-04-08 del UCP.

Descripción general

La API de Carrito del UCP (nombre de la función: dev.ucp.shopping.cart ) permite la transferencia del carrito de compras de un usuario desde las plataformas de Google, como el Modo IA en la Búsqueda de Google y Gemini, directamente a tu sitio web. Esta API admite la función de Carrito universal de Google, ya que permite una propagación unidireccional del carrito en tu sistema, principalmente a través del extremo CreateCart. Esta API es distinta de la API de Checkout, ya que no controla los pagos ni el ciclo de vida completo de la compra.

Nota: Esta versión inicial se limita a la creación y transferencia de carritos con el método CreateCart. No se admiten funciones como la actualización, la eliminación o la sincronización del contenido del carrito entre Google y tu sistema.

Beneficios clave de la implementación de CreateCart:

• Para los usuarios: Una transición fluida desde el descubrimiento de productos en Google hasta un carrito precargado en tu sitio web.
• Para los comercios: Recibe los carritos de los usuarios directamente de Google, lo que simplifica los pasos iniciales de compra para los clientes y brinda oportunidades de ventas adicionales y cruzadas en tu sitio web.

Requisitos previos

• Asegúrate de que tu sistema esté configurado para controlar la versión 2026-04-08 del UCP.
• Publica tu perfil de UCP en /.well-known/ucp e incluye la dev.ucp.shopping.cart función, como se describe en la guía de perfil de UCP. El endpoint especificado en tu perfil (por ejemplo, https://business.example.com/ucp/v1) se usará como la URL base para estas llamadas a la API.

Autenticación

Para obtener detalles sobre cómo proteger tus extremos de la API de Carrito, incluidos los métodos de autenticación admitidos , como las claves de API y OAuth 2.0, consulta la guía de autenticación y seguridad.

Próximos pasos

Consulta las cargas útiles de la API y los detalles de implementación técnica de la API de Carrito del UCP:

• API de Carrito de la versión 2026-04-08