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 im Google Wallet Die Google Wallet API unterstützt derzeit Bordkarten, Veranstaltungstickets, Kundenkarten, Angebote und Fahrkarten. In letzter Zeit Für weitere Anwendungsfälle wurde ein generischer Karten-/Tickettyp hinzugefügt.

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

Im Folgenden finden Sie Leitfäden, mit denen Sie eine Entwicklungsumgebung einrichten können, die den verschiedenen Komplexitäts- und Sicherheitsstufen von Unternehmen gerecht wird. Wenn Sie mehrere Dienstkonten verwenden, können Entwickler eine TEST-Umgebung unabhängig von ihrer PROD-Umgebung erstellen.

Grundlegende Komplexität der Einrichtung

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

  • Diese Option ermöglicht eine zentrale Verwaltung über ein Hauptkonto mit null bis vielen untergeordneten Unternehmen/Ausstellern.
  • 1 Google Cloud-Projekt
  • 1 Dienstkonto-Anmeldedaten
  • Eine einzelne Gruppe von Nutzern.

Durchschnittliche Einrichtungskomplexität

1 übergeordnetes Konto bis viele Ausstellerkonten.

  • Diese Option ermöglicht eine zentrale Verwaltung über ein Hauptkonto mit vielen untergeordneten Unternehmen.
  • 1 Google Cloud-Projekt
  • Unterschiedliche Business Console-Nutzer pro Aussteller.
  • 1 bis viele Anmeldedaten für das Dienstkonto
    • 1 Qualifikationsnachweis pro Unternehmen/Aussteller.
    • Unterschiedliche Anmeldedaten pro Unternehmen

Komplexe Einrichtungskomplexität

1 übergeordnetes Konto bis viele Ausstellerkonten.

  • Diese Option ermöglicht eine zentrale Verwaltung über ein Hauptkonto mit vielen untergeordneten Unternehmen.
  • 1 bis viele Google Cloud-Projekte
  • Unterschiedliche 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.

Support kontaktieren

Mit Karten/Tickets arbeiten

Wie lösche ich Klassen oder Objekte?

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 gruppiere ich mehrere Karten/Tickets?

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 das Ratenlimit 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.

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

Eine Liste der von der Google Wallet API zurückgegebenen Fehlercodes und Ausnahmen findest du 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 Karten-/Ticketaktualisierung Änderung des Abflugterminals, Gates, der Boardingzeit oder Abfahrtszeit 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 Ablauf der „Zeit intern“ Dokumente

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

Derzeit können Händler-IDs nicht in der Google Pay &API gelöscht oder archiviert werden Wallet-Konsole.

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

Für die App-Verknüpfung ist eine Zulassungsliste erforderlich, die Sie hier anfordern können.

Unterstützt Google Wallet Geofencing?

Geofencing wird derzeit nicht unterstützt.

Wie richte ich ein Treuepunkteprogramm ein?

Folgen Sie dieser Anleitung, um ein Registrierungs- und Treuepunkteprogramm einzurichten.

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

Verwenden Sie dieses Formular, um Google das Logo für die Zulassungsliste zu senden.

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?

In diesem Leitfaden erfährst du, wie du Ausstellerkonten über die API erstellen kannst.

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 finden Sie hier.

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

Folge dieser Konfiguration, damit deine Karte bzw. dein Ticket mit Smart-Bonus eingelöst werden kann.

JSON-Webtokens (JWTs)

Gibt es Tools, die die Implementierung und Fehlerbehebung von JWTs vereinfachen?

Ja, auf Plattformen wie www.jwt.io können Sie Ihre Tokens während des Entwicklungsprozesses decodieren und debuggen. So können Sie die von Ihnen eingereichten Inhalte überprüfen. Beachten Sie, dass Google nicht mit solchen Drittanbietern in Verbindung steht und diesbezüglich keine ausdrückliche Empfehlung abgibt.

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

Fehlerbehebung

Warum wird in den Zeiteinstellungen die falsche Uhrzeit für den Termin angezeigt?

Die auf dem Ticket angezeigte Zeit ist die Ortszeit für die Veranstaltung, mit einer Versatzzeit der Veranstaltung.

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.
  • Achten Sie darauf, dass das Logo mit hoher Zuverlässigkeit gut verfügbar ist. Leiten Sie nicht zu Bilddateien weiter, die 404-Fehler verursachen können. Deine Bilder sollten am HTTPS-Speicherort 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, klicken Sie auf den Link „Support kontaktieren“, um sich an das Supportteam zu wenden. in der linken Seitenleiste der Google Pay and Wallet Console.

Wie kann ich Feedback zum Produkt geben?

Wenn du Feedback zum Produkt geben möchtest, klicke auf „Feedback geben“ Schaltfläche oben rechts auf der Seite der Entwicklerwebsite und wählen Sie „Produktfeedback“ aus. Als Nächstes geben Sie Ihr Feedback in den Textbereich ein und klicken Sie auf „Senden“.

Wie kann ich Feedback zur Dokumentation geben?

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