In diesem Dokument werden allgemeine Begriffe und Konzepte aufgelistet, mit denen du bei der Verwendung der Google Wallet API vertraut sein solltest.
Pässe
Bestanden
Eine Karte bzw. ein Ticket ist eine Instanz eines Karten-/Ticketobjekts, das einem Nutzer zum Speichern in Google Wallet ausgestellt wird. Die Google Wallet API unterstützt eine Reihe gängiger Karten/Tickets, darunter Bordkarten, Veranstaltungstickets, Ausweise und mehr. Die Google Wallet API bietet auch einen generischen Karten-/Tickettyp, der zum Erstellen von Karten/Tickets verwendet werden kann, die ansonsten nicht speziell unterstützt werden.
In den meisten Fällen wird eine Karte / ein Ticket sowohl mit einer Karten-/Ticketklasse als auch mit einem Karten-/Ticketobjekt erstellt.
Karten-/Ticketaussteller
Ein Karten-/Ticketaussteller ist eine Entität, die Karten/Tickets erstellt und für Nutzer ausstellt, damit sie in ihrem Google Wallet-Konto gespeichert werden. Der Karten-/Ticketaussteller ist Inhaber der Karten/Tickets und kann diese erstellen, ausstellen und aktualisieren. Karten-/Ticketaussteller können einzelne Entwickler, Unternehmen und Organisationen sowie Aggregatoren sein, die Karten/Tickets im Namen anderer erstellen und ausstellen, z. B. ein Unternehmen, das sich auf die Implementierung von Veranstaltungstickets oder Gutscheinen für Einzelhändler spezialisiert hat.
Karten-/Ticketklasse
Eine Karten-/Ticketklasse kann als eine freigegebene Vorlage betrachtet werden, aus der Karten/Tickets erstellt werden. Mit einer Karten-/Ticketklasse werden bestimmte Attribute definiert, die in allen Karten/Tickets enthalten sind, in denen sie verwendet wird. Ein Karten-/Ticketaussteller kann mehrere Klassen mit jeweils eigenen charakteristischen Eigenschaften erstellen, die Attribute wie Stil und Erscheinungsbild definieren, sowie zusätzliche Funktionen wie Smart-Bonus und die Registrierung und Anmeldung.
In den meisten Fällen wird eine Karte bzw. ein Ticket erstellt, indem eine Karten-/Ticketklasse zum Definieren der Vorlage der Karte bzw. des Tickets und ein Karten-/Ticketobjekt zum Definieren der Details der jeweiligen Karte bzw. des ausgewählten Tickets bereitgestellt wird.
Karten-/Ticketobjekt
Ein Karten-/Ticketobjekt definiert eine einzelne Karte bzw. ein einzelnes Ticket, das einem Nutzer zum Speichern in Google Wallet ausgestellt wird. Karten-/Ticketobjekte enthalten oft nutzerspezifische Informationen. Während mit einer Karten-/Ticketklasse beispielsweise definiert wird, wie eine Geschenkkarte für ein bestimmtes Geschäft aussieht, liefert das Karten-/Ticketobjekt spezifische Details wie Guthaben oder Ablaufdatum.
Im Gegensatz zu Karten-/Ticketklassen, die von vielen Karten-/Ticketinstanzen gemeinsam verwendet werden können, muss für jede ausgestellte Karte bzw. jedes Karten-/Ticketobjekt ein Karten-/Ticketobjekt erstellt werden.
Persönliche Ausweise
Einige Karten/Tickets, die Sie mit der Google Wallet API erstellen, enthalten möglicherweise vertrauliche Nutzerdaten. Diese Karten/Tickets erfordern zusätzlichen Schutz, um die Daten deiner Nutzer zu schützen. Sie werden in der Google Wallet API mithilfe des Typs Generischer persönlicher Ausweis anders verwaltet. Der generische persönliche Ausweis sollte verwendet werden, wenn deine Karte bzw. dein Ticket sensible Daten (wie in den Richtlinien zur Fairen Nutzung der Google Wallet API definiert) enthalten ist und bei der Einrichtung zusätzlichen Datenschutzkontrollen und Überprüfungen unterliegen kann.
Smart-Bonus
Smart-Bonus ist ein von Google entwickeltes Nahfeldkommunikationsprotokoll, mit dem Daten zwischen einem Mobilgerät und einem NFC-Terminal übertragen werden können. Mit der Smart-Bonus-Technologie können Nutzer in Google Wallet gespeicherte Karten/Tickets einlösen, indem sie ihr Smartphone an ein kompatibles NFC-Terminal halten.
Wenn Sie das Smart-Bonus-Protokoll mit Ihren Karten/Tickets verwenden möchten, müssen Sie eine Beziehung zu einem Smart-Bonus-fähigen Terminalanbieter herstellen.
APIs und SDK
Google Wallet API
Die Google Wallet API ist ein von Google bereitgestellter Dienst, mit dem du Karten/Tickets erstellen und ausstellen kannst, damit Nutzer sie in ihren Google Wallets speichern können. Die API kann auf verschiedene Arten verwendet werden, z. B. über die Google Wallet REST API, das Google Wallet Android SDK und die Google Wallet-Konsole.
Google Wallet REST API
Die Google Wallet REST API ist eine Schnittstelle zum programmatischen Erstellen und Verwalten von Karten/Tickets. Dazu werden HTTP-Anfragen an die Google Wallet API gesendet.
Wenn Sie die Google Wallet REST API verwenden möchten, benötigen Sie außerdem ein Google Cloud-Konto, um ein Dienstkonto zu erstellen, mit dem Anfragen an die Google Wallet REST API authentifiziert werden.
Google Wallet Android SDK
Das Google Wallet Android SDK bietet eine Reihe praktischer Methoden für die Arbeit mit der Google Wallet API in deinen Android-Apps, z. B. das Erstellen und Ausstellen von Karten/Tickets.
Zu Google Wallet hinzufügen
„Zu Google Wallet hinzufügen“ Schaltfläche
Die Option „Zu Google Wallet hinzufügen“ Die Schaltfläche ist ein von Google genehmigtes Asset, um einem Nutzer eine Karte bzw. ein Ticket zu präsentieren. Wenn ein Nutzer auf die Schaltfläche klickt oder tippt, wird „Zu Google Wallet hinzufügen“ angezeigt. muss ausgelöst werden, um das Hinzufügen der ausgestellten Karte bzw. des ausgestellten Tickets zum Google Wallet-Konto des Nutzers zu starten.
Es wird empfohlen, die Option „Zu Google Wallet hinzufügen“ zu verwenden wenn möglich, da es sich um ein vertrautes UI-Element handelt, mit dem die Nutzenden bereits interagieren.
Assets und Richtlinien für die Verwendung der Schaltfläche sind in den Markenrichtlinien für die Google Wallet API verfügbar.
„Zu Google Wallet hinzufügen“ Link
Mit „Zu Google Wallet hinzufügen“ können Sie einem Nutzer eine Karte bzw. ein Ticket mit einem normalen Hyperlink ausstellen. Diese Funktion kann überall dort verwendet werden, wo Hyperlinks verwendet werden können, z. B. für E-Mails, SMS, Websites und mobile Apps.
„Zu Google Wallet hinzufügen“ Links werden erstellt, indem ein signiertes JWT an die URL https://pay.google.com/gp/v/save/ angehängt wird.
Ausstellerkonto
Demomodus
Wenn du dein Ausstellerkonto erstellst, befindet es sich im Demomodus bis Ihr Veröffentlichungszugriff genehmigt wurde. Im Demomodus können Sie Karten/Tickets erstellen, aber nur Nutzern mit der Rolle „Administrator“ ausstellen oder „Entwickler“ Rollen deines Ausstellerkontos oder Nutzer, die als Testkonten in der Google Wallet-Konsole hinzugefügt wurden.
Im „Demomodus“ beginnt der Titel aller Karten/Tickets, die du ausstellst, automatisch mit den Worten „[TEST ONLY]“. um anzugeben, dass die Karte bzw. das Ticket nur zu Testzwecken dient.
Testkonten
Wenn sich Ihr Ausstellerkonto im Demomodus befindet und Sie Karten/Tickets an Nutzer ohne Administratorberechtigungen senden möchten oder „Entwickler“ Rollen für dein Konto, musst du sie in der Google Wallet Console als Testkonten hinzufügen. Nutzer, die als Testkonten registriert sind, können von Ihnen ausgestellte Karten/Tickets zu ihrem Google Wallet hinzufügen. Dies ist nützlich, wenn Sie Ihre Karten/Tickets im Demomodus mit einer größeren Zielgruppe testen möchten.
Unternehmensprofil
Wenn du ein Ausstellerkonto für die Google Wallet API erstellen möchtest, musst du bei der Registrierung für die Google Pay &App ein Unternehmensprofil einrichten Wallet-Konsole Ein Unternehmensprofil liefert Google grundlegende Informationen zu Ihrem Unternehmen oder Ihrer Organisation. Es muss für den Veröffentlichungszugriff genehmigt werden.
Veröffentlichungszugriff
Bevor Sie Karten/Tickets ausstellen können, die Nutzer in Google Wallet speichern können, müssen Sie für den Veröffentlichungszugriff genehmigt sein. Damit Sie den Veröffentlichungszugriff erhalten, müssen Sie mindestens eine Karten-/Ticketklasse erstellt haben und ein vollständiges Unternehmensprofil haben. Aussteller, die Karten/Tickets über das Google Wallet Android SDK ausstellen möchten, müssen auch den SHA-1-Fingerabdruck für ihre App einreichen.
Wenn du Veröffentlichungszugriff anfordern möchtest, rufe die Google Wallet Console auf und klicke auf „Veröffentlichungszugriff anfordern“. Schaltfläche. Das Google Wallet-Team prüft deine Anfrage und benachrichtigt dich, sobald du Veröffentlichungszugriff erhalten hast.
Authentifizierung
JSON-Webtoken (JWT)
JSON Web Tokens sind ein gängiger Branchenstandard für die sichere Übertragung von Informationen als JSON-Objekt. Wenn du die Google Wallet API verwendest, codieren Sie die Details des Karten-/Ticketobjekts, das Sie zum Erstellen einer Karten-/Ticketinstanz im JWT-Format (ausgesprochen „jot“) verwenden möchten, und senden dieses JWT dann in einer Anfrage an die Google Wallet API.
JWTs werden sicher aufbewahrt, indem sie mit einem gemeinsamen Secret signiert werden, bevor sie an die Google Wallet API gesendet werden. Wenn du die Google Wallet REST API verwendest, ist das Signatur-Secret dein Google Cloud-Dienstkontoschlüssel. Wenn Sie das Google Wallet Android SDK verwenden, ist das Signatur-Secret der SHA-1-Fingerabdruck für Ihre Android-App.
Dienstkonto
Ein Google Cloud-Dienstkonto ist eine spezielle Art von Konto, das normalerweise von einer Anwendung oder Computing-Arbeitslast und nicht von einer Person verwendet wird. Bei der Google Wallet API verwendest du ein Dienstkonto, um Anfragen zu authentifizieren, die an die Google Wallet REST API gesendet werden.
Dienstkonten werden in der Google Cloud Console erstellt. Wenn Sie ein Dienstkonto verwenden möchten, müssen Sie außerdem die Google Wallet API in der Cloud Console aktivieren, damit das Dienstkonto Anfragen an die Google Wallet REST API senden kann.
Dienstkontoschlüssel
Ein Dienstkontoschlüssel ist die Anmeldedaten, mit denen Sie Aufrufe an die Google Wallet REST API authentifizieren. Der Dienstkontoschlüssel gilt als streng vertraulich und muss geheim gehalten werden, da er über die Google Wallet REST API Zugriff auf viele Funktionen des Karten-/Ticketausstellers Ihres Kontos gewährt, einschließlich des Erstellens von Karten-/Ticketklassen und Karten-/Ticketobjekten.
SHA-1-Fingerabdruck
Der SHA-1-Fingerabdruck Ihres Android-App-Signaturzertifikats ist die Anmeldedaten für Aufrufe der Google Wallet API, wenn Sie das Google Wallet Android SDK verwenden. Der SHA-1-Fingerabdruck Ihres Zertifikats wird mit Gradle oder keytool generiert. Damit Sie den Fingerabdruck zur Authentifizierung Ihrer Anfragen verwenden können, müssen Sie ihn in der Google Wallet Console registrieren.