API Cart

Este guia descreve como fazer a integração com a API Universal Commerce Protocol (UCP) Cart, permitindo que os usuários criem e gerenciem um carrinho de compras nas plataformas do Google, incluindo o Modo IA na Pesquisa Google e no Gemini. Esse recurso foi projetado para a criação de cestas antes que o usuário expresse a intenção explícita de finalizar a compra.

Visão geral

A API UCP Cart (nome do recurso: dev.ucp.shopping.cart ) permite a transferência do carrinho de compras de um usuário das plataformas do Google, como o Modo IA na Pesquisa Google e no Gemini, diretamente para seu site. Essa API oferece suporte ao recurso de carrinho universal do Google, permitindo uma população unidirecional do carrinho no seu sistema, principalmente pelo endpoint CreateCart. Essa API é diferente da API Checkout, porque não processa pagamentos nem o ciclo de vida completo da compra.

Principais benefícios da implementação CreateCart:

  • Para usuários:uma transição perfeita da descoberta de produtos no Google para um carrinho pré-preenchido no seu site.
  • Para comerciantes:receba carrinhos de usuários diretamente do Google, simplificando as etapas iniciais de compra para os clientes e oferecendo oportunidades de vendas adicionais e cruzadas no seu site.

Pré-requisitos

  • Verifique se o sistema está configurado para processar a versão 2026-04-08 do UCP.
  • Publique seu perfil UCP em /.well-known/ucp e inclua o dev.ucp.shopping.cart recurso, conforme descrito no guia de perfil UCP. O endpoint especificado no seu perfil (por exemplo, https://business.example.com/ucp/v1) será usado como o URL base para essas chamadas de API.

Autenticação

Para mais detalhes sobre como proteger os endpoints da API Cart, incluindo métodos de autenticação aceitos, como chaves de API e OAuth 2.0, consulte o guia de autenticação e segurança.

Próximas etapas

Confira os payloads da API e os detalhes técnicos de implementação da API UCP Cart:

Avançar
Vinculação de identidade: OAuth 2.0