Implementierung der Cart API

In diesem Leitfaden finden Sie die technische API-Referenz und die Nutzlastschemata für die Integration der Universal Commerce Protocol (UCP) Cart API in Version 2026-04-08.

Bevor Sie Ihre Endpunkte erstellen, sollten Sie sich die Cart API Übersicht ansehen, um sich mit den allgemeinen Konzepten und Voraussetzungen vertraut zu machen.

Einkaufswagen erstellen

Mit diesem Endpunkt kann eine neue Einkaufswagensitzung erstellt werden. Implementieren Sie dazu den Endpunkt CreateCart (POST /carts). Wenn ein Nutzer seinen Einkaufswagen übertragen möchte, ruft Google diesen Endpunkt mit den Details zu den Artikeln auf. Ihr System muss mit einer continue_url antworten, die den Nutzer zu seinem vorab gefüllten Einkaufswagen auf Ihrer Website weiterleitet.

  • Endpunkt:POST /carts
  • Auslöser:Der Nutzer klickt auf „In den Einkaufswagen“ und fügt dem Einkaufswagen des Händlers den ersten Artikel hinzu.

Anfrage:Google sendet das Array der line_items, die dem Einkaufswagen hinzugefügt werden sollen.

Beispielanfrage:

{
  "line_items": [
    {
      "item": {
        "id": "item_123"
      },
      "quantity": 2
    }
  ]
}

Antwort:Sie geben die initialisierte Einkaufswagensitzung zurück, einschließlich der Details zu den Artikeln, der Summen und einer continue_url. Das Feld continue_url in der Antwort muss den Nutzer zu einer Seite auf Ihrer Website zurückleiten, auf der er den Einkaufswagen weiter verwalten kann. In der Regel wird hier auf Ihre Einkaufswagen- oder Zahlungsseite verlinkt, wobei die Sitzung mit der id vorab geladen wird.

Beispielantwort:

{
  "ucp": {
    "version": "2026-04-08",
    "capabilities": {
      "dev.ucp.shopping.cart": [{"version": "2026-04-08"}]
    }
  },
  "id": "cart_abc123",
  "line_items": [
    {
      "id": "li_1",
      "item": {
        "id": "item_123",
        "title": "Red T-Shirt",
        "price": 2500
      },
      "quantity": 2,
      "totals": [
        {"type": "subtotal", "amount": 5000},
        {"type": "total", "amount": 5000}
      ]
    }
  ],
  "currency": "USD",
  "totals": [
    {
      "type": "subtotal",
      "amount": 5000
    },
    {
      "type": "total",
      "amount": 5000,
      "display_text": "Estimated total (taxes calculated at checkout)"
    }
  ],
  // Used for redirecting the user back to the merchant's cart experience from Google surfaces.
  "continue_url": "https://business.example.com/checkout?cart=cart_abc123",
  // Indicate the timestamp at which the cart session will expire and become invalid.
  "expires_at": "2026-01-16T12:00:00Z"
}

Fehlerbehandlung

Vollständige Richtlinien zur Formatierung von Fehlermeldungen und zur Unterscheidung zwischen Protokoll- und Geschäftslogikfehlern finden Sie unter Fehlercodes.

Weiter
Gutscheincodes und Rabatte