Häufig gestellte Fragen zur Google Wallet API

Erste Schritte

Was ist die Google Wallet API?

Mit der Google Wallet API können Entwickler digitale Karten/Tickets in Google Wallet erstellen. Die Google Wallet API unterstützt derzeit Bordkarten, Veranstaltungstickets, Kundenkarten, Angebote und Fahrkarten. Außerdem wurde für weitere Anwendungsfälle ein allgemeiner Typ Karte/Ticket hinzugefügt.

Wie kann ich meine Entwicklungsumgebung entsprechend meinen Geschäftsanforderungen und der jeweiligen Komplexität einrichten?

Im Folgenden finden Sie Leitfäden für die Einrichtung einer Entwicklungsumgebung, die den verschiedenen Komplexitäts- und Sicherheitsstufen eines Unternehmens gerecht wird. Die Verwendung mehrerer Dienstkonten ermöglicht es Entwicklern, eine TEST-Umgebung unabhängig von ihrer PROD-Umgebung zu erstellen.

Geringe Einrichtungskomplexität

1 Business Console-Konto oder 1 übergeordnetes Business Console-Konto bis viele Ausstellerkonten.

  • Diese Option erlaubt eine zentrale Verwaltung über ein Hauptkonto mit keinen bis vielen untergeordneten Unternehmen/Ausstellern.
  • 1 Google Cloud-Projekt
  • 1 Paar Anmeldeinformationen für das Dienstkonto
  • Eine einzelne Gruppe von Nutzern

Durchschnittliche Einrichtungskomplexität

1 übergeordnetes Konto bis viele Ausstellerkonten.

  • Diese Option erlaubt eine zentrale Verwaltung über ein Hauptkonto mit vielen untergeordneten Unternehmen.
  • 1 Google Cloud-Projekt
  • Mehrere separate Business Console-Nutzer pro Aussteller
  • 1 Anmeldedatensatz bis viele Anmeldedatensätze für das Dienstkonto
    • 1 Anmeldedatensatz pro Unternehmen/Aussteller
    • Separate Anmeldedaten pro Unternehmen

Hohe Einrichtungskomplexität

1 übergeordnetes Konto bis viele Ausstellerkonten.

  • Diese Option erlaubt eine zentrale Verwaltung über ein Hauptkonto mit vielen untergeordneten Unternehmen.
  • 1 bis viele Google Cloud-Projekte
  • Mehrere separate Business Console-Nutzer pro Aussteller
  • 1 Anmeldedatensatz bis viele Anmeldedatensätze für das Dienstkonto
    • 1 PROD-Anmeldedatensatz pro Unternehmen/Aussteller
    • 1 DEV-Anmeldedatensatz pro Unternehmen/Aussteller

Support kontaktieren

Mit Karten/Tickets arbeiten

Wie kann ich Klassen oder Objekte löschen?

Derzeit können Klassen oder Objekte nicht aus Google Wallet gelöscht werden. Nutzer können jedoch die Verknüpfung von Objekten mit Google Wallet aufheben.

Wie kann ich mehrere Karten/Tickets gruppieren?

Mit der GroupingID kannst du Karten/Tickets gruppieren.

Wie aktualisiere ich nur einen Teil einer Karte bzw. eines Tickets?

In unserem Leitfaden für bessere Leistung erfährst du, wie du Teilaktualisierungen mit PATCH-Anfragen durchführst.

Kann ich Karten/Tickets im Batch erstellen?

In unserem Leitfaden für bessere Leistung erfährst du, wie du Batchanfragen mit der API ausführst.

Allgemeine Fragen

Was ist das Ratenlimit für Anfragen, die an die Google Wallet API gesendet werden?

Aufrufe der Google Wallet API sind auf 20 Anfragen pro Sekunde begrenzt.

Für die Google Wallet API gibt es kein offizielles SLA. Wir empfehlen jedoch ein Zeitlimit von 10 Sekunden, basierend auf einer Latenz im 99. Perzentil von etwa 5 Sekunden. Die Latenz hängt oft von externen Faktoren ab, z. B. von der Zeit, die benötigt wird, um ein Bild abzurufen, das auf einem externen Server gehostet wird, wenn ein Objekt mit diesem Bild eingefügt wird. Dies hängt von der Latenz des externen Servers ab.

Warum dürfen keine persönlichen Bilder auf Karten/Tickets in Google Wallet verwendet werden?

Google Wallet unterstützt keine persönlichen Bilder auf Karten/Tickets, da laut aktuellen Bestimmungen alle Nutzer das Recht haben, die Erhebung oder Verarbeitung sensibler Daten abzulehnen. Wenn sensible Daten (persönliche Bilder) Teil des wertvollen Objekts (in einem JWT) sind, kann es zu Hosting-Problemen kommen, wenn die Daten öffentlich werden, was außerhalb der ursprünglichen Einwilligungserklärung liegt. Um die Vertraulichkeit von Daten zu gewährleisten, sind persönliche Bilder nicht zulässig. Wir arbeiten daran, in Zukunft auch private Bilder zu unterstützen.

Welche Fehlercodes werden von der Google Wallet API zurückgegeben?

Eine Liste der Fehlercodes und Ausnahmen, die von der Google Wallet API zurückgegeben werden, finden Sie unter Fehlercodes.

Wie aktiviere ich Push-Benachrichtigungen?

Vom Entwickler erstellte Push-Benachrichtigungen werden derzeit nicht von Google Wallet unterstützt. Google Wallet sendet jedoch zeitnah Benachrichtigungen für die folgenden Karten/Tickets. Vom Entwickler erstellte Push-Benachrichtigungen werden derzeit nicht von Google Wallet unterstützt.

Branche Benachrichtigung Ausgelöst Dokumentation
Ereignis Erinnerung eingerichtet 3 Stunden vor dem Termin Dokumente
Bordkarte Erinnerung eingerichtet 3 Stunden vor Abflug Dokumente
Bordkarte Kartenaktualisierung Änderung des Abflugterminals, Gates, der Boardingzeit oder Abflugzeit Dokumente
Angebotskarte Erinnerung an Ablauffrist 48 Stunden vor Ablauf der Angebotskarte Dokumente
Allgemein Erinnerung eingerichtet 24 Stunden vor Beginn des „Zeitintervalls“ Dokumente
Allgemein Erinnerung an Ablauffrist 48 Stunden vor Ende des „Zeitintervalls“ Dokumente

Können Händler-IDs gelöscht werden?

Derzeit können Händler-IDs nicht über die Google Pay & Wallet Console gelöscht oder archiviert werden.

Wie verwende ich die Funktion zur App-Verknüpfung?

Zur App-Verknüpfung muss eine Zulassungsliste erstellt werden, die du hier anfordern kannst.

Unterstützt Google Wallet Geofencing?

Geofencing wird derzeit nicht unterstützt.

Wie richte ich ein Treuepunkteprogramm ein?

Folge dieser Anleitung, um ein Registrierungs- und Treuepunkteprogramm einzurichten.

Wie kann ich Google mein Logo für Fahrkarten senden?

Sende das Logo über dieses Formular an Google, damit es zur Zulassungsliste hinzugefügt werden kann.

Wie werden die base64-codierten Nutzerprofildaten richtig verarbeitet?

Verwende während des gesamten Prozesses die UTF‑8‑Codierung. Der JSON-String wird zuerst mit UTF‑8 und anschließend mit android.util.Base64 mit den Optionen NO_WRAP und URL_SAFE codiert. Dies entspricht Abschnitt 4 von RFC 3548.

Wie erstelle ich Ausstellerkonten programmatisch?

Weitere Informationen zum Erstellen von Ausstellerkonten über die API findest du hier.

Smart-Bonus

Benötige ich ein spezielles NFC-Lesegerät für Google Smart-Bonus-Karten?

Das Terminal muss Smart-Bonus-fähig sein. Eine Liste der zertifizierten Anbieter findest du hier.

Wie kann ich dafür sorgen, dass meine Karten/Tickets mit NFC funktionieren?

Folge dieser Konfigurationsanleitung, damit deine Karte bzw. dein Ticket mit Smart-Bonus abgerufen werden kann.

JSON-Webtokens (JWTs)

Gibt es Tools für eine einfachere Implementierung und Fehlerbehebung von JWTs?

Ja, auf Plattformen wie www.jwt.io kannst du deine Tokens während des Entwicklungsprozesses decodieren und debuggen. So lassen sich die von dir eingereichten Inhalte überprüfen. Beachte, dass Google nicht mit solchen Drittanbietern in Verbindung steht und diesbezüglich keine ausdrückliche Empfehlung abgibt.

Du kannst Klassen und Objekte vorab mit der API erstellen , bevor du den Link zum Speichern des Tickets (JWT) erstellst.

Fehlerbehebung

Warum wird in der Zeiteinstellung die falsche Uhrzeit für das Ereignis angezeigt?

Die Zeit auf der Karte/dem Ticket wird in deiner Ortszeit angegeben, mit dem Zeitunterschied zur Ortszeit des Veranstaltungsorts als Zusatz.

Auf den Karten/Tickets, die ich erstellt habe, wird mein Logo nicht gerendert. Woran könnte das liegen?

  • Prüfe zuerst, ob dein Logo den Richtlinien entspricht und im PNG-Format gespeichert ist.
  • Das Logo muss mit hoher Zuverlässigkeit gut zugänglich sein. Leite den Nutzer nicht zu Bilddateien weiter, die 404‑Fehler verursachen können. Ihre Bilder sollten am HTTPS‑Standort gehostet werden, da sie ansonsten in Google Wallet nicht sichtbar sind.
  • Achte darauf, dass alle in der API als erforderlich gekennzeichneten Felder in der Karte bzw. dem Ticket festgelegt sind.

Support und Feedback

Wie erreiche ich den technischen Support?

Weitere Hilfe erhältst du vom Supportteam. Klicke dazu in der linken Seitenleiste der Google Pay and Wallet Console auf die Schaltfläche „Support kontaktieren“.

Wie kann ich Feedback zum Produkt geben?

Wenn Sie Feedback zum Produkt geben möchten, klicken Sie rechts oben auf der Seite der Entwicklerwebsite auf die Schaltfläche „Feedback geben“ und wählen Sie „Produktfeedback“ aus. Gib dann dein Feedback in den Textbereich ein und klicke auf „Senden“.

Wie kann ich Feedback zur Dokumentation hinterlassen?

Wenn du Feedback zur Dokumentation geben möchtest, klicke rechts oben auf der Seite der Entwicklerwebsite auf die Schaltfläche „Feedback geben“ und wähle „Feedback zur Dokumentation“ aus. Gib dann dein Feedback in den Textbereich ein und klicke auf „Senden“.