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 Karten-/Tickettyp hinzugefügt.
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.
- Diese Option erlaubt eine zentrale Verwaltung über ein Hauptkonto mit keinen bis vielen untergeordneten Unternehmen/Ausstellern.
- 1 Google Cloud-Projekt
- 1 Paar Anmeldedaten 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
- Unterschiedliche Business Console-Nutzer pro Aussteller.
- 1 Anmeldedatensatz bis viele Anmeldedatensätze für das Dienstkonto
- 1 Anmeldedatensatz pro Unternehmen/Aussteller
- Separate Anmeldedaten pro Unternehmen
Komplexe 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 bis viele Anmeldedaten für das Dienstkonto
- 1 PROD-Anmeldedatensatz pro Unternehmen/Aussteller
- 1 DEV-Zertifizierungsnachweis pro Unternehmen/Aussteller.
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
Wie hoch ist die Ratenbegrenzung für Anfragen, die an die Google Wallet API gesendet werden?
Für Aufrufe der Google Wallet API gilt eine Beschränkung von 20 Anfragen pro Sekunde.
Warum sind persönliche Bilder auf Karten/Tickets in Google Wallet nicht zulässig?
Google Wallet unterstützt keine persönlichen Bilder auf Karten/Tickets, da alle Verbraucher gemäß den aktuellen Bestimmungen das Recht haben, der Erhebung oder Verarbeitung sensibler Daten zu widersprechen. 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 nicht in der ursprünglichen Einwilligungsvereinbarung abgedeckt ist. Um die Vertraulichkeit von Daten zu gewährleisten, sind persönliche Bilder nicht zulässig. Wir arbeiten daran, persönliche Bilder in Zukunft 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 | docs |
| Bordkarte | Erinnerung eingerichtet | 3 Stunden vor Abflug | docs |
| Bordkarte | Karte/Ticket aktualisieren | Änderung des Abflugterminals, Gates, der Boardingzeit oder Abflugzeit | Dokumente |
| Angebotskarte | Erinnerung an Ablauffrist | 48 Stunden vor Ablauf der Angebotskarte | docs |
| Allgemein | Erinnerung eingerichtet | 24 Stunden vor Beginn des „Zeitintervalls“ | docs |
| 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, die die Implementierung und Fehlerbehebung von JWTs vereinfachen?
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.
Die URL meines JWT-Links überschreitet die Browserbeschränkung von 1.800 Zeichen. Was soll ich tun?
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/des Tickets wird in deiner Ortszeit angegeben, mit dem Zeitunterschied zur Ortszeit des Veranstaltungsorts als Zusatz.
Mein Logo wird nicht auf den von mir erstellten Karten/Tickets gerendert. Woran könnte das liegen?
- Achten Sie darauf, dass Ihr 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.
Support und Feedback
Wie erreiche ich den technischen Support?
Wenn Sie weitere Hilfe benötigen, wenden Sie sich an das Supportteam, indem Sie in der Google Pay and Wallet Console in der linken Seitenleiste auf „Support kontaktieren“ klicken.
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. 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 einfach rechts oben auf der Seite der Entwicklerwebsite auf „Feedback geben“ und wähle „Feedback zur Dokumentation“ aus. Gib dann dein Feedback in den Textbereich ein und klicke auf „Senden“.