Implementierung der Cart API

Dieser Leitfaden enthält die technische API-Referenz und die Nutzlastschemas für die Integration der UCP Cart API in Version 2026-04-08.

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

Einkaufswagen erstellen

Mit diesem Endpunkt kann eine neue Warenkorbsitzung erstellt werden. Implementieren Sie zur Integration den CreateCart-Endpunkt (POST /carts). Wenn ein Nutzer seinen Warenkorb übertragen möchte, ruft Google diesen Endpunkt mit allen Details zu den Positionen auf. Ihr System muss mit einer continue_url antworten, die den Nutzer zu seinem vorausgefüllten Warenkorb auf Ihrer Website weiterleitet.

  • Endpunkt:POST /carts
  • Trigger:Eine einzelne CreateCart-Anfrage (POST /carts) wird nur ausgelöst, wenn der Nutzer auf die Schaltfläche zum Übertragen klickt (z. B. Zur Kasse des Händlers), um seinen Einkaufswagen in Ihren Shop zu übertragen.

Einkaufswagen-Ablauf

So funktionieren der Warenkorb-Ablauf und der Status:

  • Auf Google speichern:Wenn ein Nutzer Artikel in den Einkaufswagen legt, werden diese lokal von Google gespeichert. Google löst nicht mehrere API-Aufrufe aus, wenn Artikel hinzugefügt werden.
  • Die Nutzlast:Die einzelne POST /carts-Anfrage enthält das vollständige Array aller gesammelten line_items auf einmal.
  • Weiterleitung und Status:Das Backend des Händlers antwortet mit einem continue_url, das auf den vorausgefüllten Einkaufswagen auf seiner Website verweist.

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

Beispielanfrage:

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

Antwort:Sie geben die initialisierte Warenkorbsitzung zurück, einschließlich der Details zu den Positionen, den Summen und einer continue_url. Das Feld continue_url in der Antwort muss den Nutzer zurück zu einer Seite auf Ihrer Website leiten, auf der er den Einkaufswagen weiter verwalten kann. Dieser Link führt in der Regel zu Ihrem Einkaufswagen oder Ihrer Zahlungsseite, wobei die Sitzung durch 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