Grundlegende Informationen
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.
API-Ausnahmen und Problembehebung
- Was bedeutet diese Ausnahme?
-
Wenn bei der Arbeit mit der Google Wallet API API-Ausnahmen auftreten, findest du in der folgenden Tabelle Erläuterungen und Vorschläge:
Ausnahme Beispielmeldung Vorschlag 400 – BadRequestException Die Anfrage enthält ein ungültiges Argument. Ungültige Ressourcen-ID: {1234567891234567899 - ABCD1234567}. Prüfe die Datenstruktur auf Typ, Format und Länge und gib das richtige Argument ein. 403 – PermissionDeniedException Berechtigung verweigert Achte darauf, dass die richtige E-Mail-Adresse des Dienstkontos ein autorisierter Nutzer in deiner Business Pay and Wallet Console ist. 404 - NotFoundException Wallet-Objekt {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} nicht gefunden. Führe einen GET-Vorgang für die Objekt-ID aus, bevor du es vor einer PATCH- oder PUT-Anfrage testest. So kannst du sicherstellen, dass ein Objekt für die Aktualisierung vorliegt und dass es das neueste ist. 404 - IssuerClassNotFoundException Die Wallet-Objektklasse {1234567891234567899.ABCD.1234567} wurde nicht gefunden. Führe bei einem Update einen GET-Vorgang vor einer PATCH- oder PUT-Anfrage aus. So kannst du sicherstellen, dass auf eine Klasse verwiesen werden kann und dass sie die neueste ist. Achte außerdem darauf, dass die richtige Nutzlast (Objekt und Klasse) in der Anfrage verwendet wird. 409 - AlreadyExistsException Die Wallet-Objektklasse {1234567891234567899.ABCD.1234567} ist bereits vorhanden. Führe einen GET-Vorgang für die Klassen-ID durch, bevor du versuchst, dieselbe Klassen-ID zu erstellen. Wenn die Ressource schon vorhanden ist, solltest du PATCH oder PUT verwenden. - 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. Deine 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.
- 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
- 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
- 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
Allgemeine Fragen
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 |
|---|---|---|---|
| Veranstaltung | Erinnerung eingerichtet | 3 Stunden vor dem Ereignis | Dokumente |
| Bordkarten | Erinnerung eingerichtet | 3 Stunden vor Abflug | Dokumente |
| Bordkarten | Bordkartenaktualisierung | Ä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 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 verwende ich die Funktion zur App-Verknüpfung?
Zur App-Verknüpfung muss eine Zulassungsliste erstellt werden, die du hier anfordern kannst.
Warum wird in der Zeiteinstellung die falsche Uhrzeit für das Ereignis angezeigt?
Die Zeit auf der Karte/des Tickets wird in deiner Ortszeit angegeben, mit dem Zeitunterschied zur Ortszeit des Veranstaltungsorts als Zusatz.
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.
Mein Logo wird nicht auf den von mir erstellten Karten/Tickets gerendert. Woran könnte das liegen?
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.
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 kann ich mehrere Karten/Tickets gruppieren?
Mit der GroupingID kannst du Karten/Tickets gruppieren.
Wie erstelle ich Ausstellerkonten programmatisch?
Weitere Informationen zum Erstellen von Ausstellerkonten über die API findest du hier.
Die URL meines JWT-Links überschreitet die Browserbeschränkung von 1.800 Zeichen. Was kann ich tun?
Du kannst Klassen und Objekte vorab mit der API erstellen, bevor du den Link zum Speichern des Tickets (JWT) erstellst.
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.
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.
Einrichtung der Entwicklungsumgebung
Wie kann ich meine Entwicklungsumgebung entsprechend meinen Geschäftsanforderungen und der jeweiligen Komplexität einrichten?
Im Folgenden findest du 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.
Durchschnittliche Einrichtungskomplexität
1 übergeordnetes Business Console-Konto bis viele Ausstellerkonten.
Hohe Einrichtungskomplexität
1 übergeordnetes Business Console-Konto bis viele Ausstellerkonten.
Wie erreiche ich den technischen Support?
Weitere Hilfe erhältst du vom Supportteam über die Google Pay and Wallet Console.
Feedback geben
Wie kann ich Feedback zum Produkt geben?
Wenn du Feedback zum Produkt geben möchtest, klicke rechts oben auf der Seite der Entwicklerwebsite auf die Schaltfläche „Feedback geben“ und wähle „Produktfeedback“ aus. Dort kannst du dein Feedback in den Textbereich eingeben und dann auf „Senden“ klicken.
Wie kann ich Feedback zur Dokumentation geben?
Wenn du Feedback zur Dokumentation geben möchtest, klickst du einfach rechts oben auf der Seite der Entwicklerwebsite auf „Feedback geben“ und wählst „Feedback zur Dokumentation“ aus. Gib dann dein Feedback in den Textbereich ein und klicke auf „Senden“.