Auf dieser Seite wird die Beziehung zwischen Klassen und Objekten beschrieben, die für die Funktionsweise der Google Wallet API ausschlaggebend ist. Außerdem wird auf dieser Seite beschrieben, wie Objekte mit Nutzern verknüpft werden.
Klassen und Objekte
Die Google Wallet API nutzt das Konzept eines Objekts, um die physischen Bordkarten eines einzelnen Nutzers digital darzustellen. Die API nutzt das Konzept einer Klasse, um die Verwaltung gemeinsamer Daten für alle Nutzer zu ermöglichen. Für die Abdeckung bestimmter Anwendungsfälle hat jede Branche ein eigenes Objekt und eine eigene Klasse.
Beispielsweise wird jedes Google Wallet-Ticket, das ein Nutzer in seiner Google Wallet-App hat, durch ein FlightObject repräsentiert, das auf ein FlightClass-Element verweist.
Zur Vereinfachung der Implementierung von Änderungen, die für alle Bordkarten gelten müssen, verweist jedes Objekt auf eine Klasse.
Eine Klasse enthält gemeinsame Daten für verschiedene Objekte. Beispielsweise speichert FlightClass den localScheduledDepartureDateTime, während FlightObject die passengerName einer Person speichert.
Die Klasse und das Objekt können eine 1:1-Beziehung haben. Eine Klasse kann jedoch von vielen Objekten referenziert werden.
Änderungen an der Klasse oder dem Objekt werden sofort übernommen. Nutzer können diese Änderungen nach dem Synchronisieren in der Google Wallet App sehen.
Objekte und Verknüpfungen
Die Google Wallet API nutzt das Konzept eines Object zur Darstellung von Bordkarten. Ein FlightObject steht beispielsweise für jede Bordkarte eines Nutzers in der Google Wallet App.
Nachdem ein Nutzer auf die Schaltfläche Zu Wallet hinzufügen geklickt hat, um die Bordkarte hinzuzufügen, wird von der API ein Object eingefügt, das eine Verknüpfung zwischen dem Objekt und dem Nutzer herstellt. Wenn der Nutzer also noch einmal auf die Schaltfläche klickt, ist bereits ein Link zu Object vorhanden.
Wenn ein Nutzer seine Karte oder sein Ticket aus der Google Wallet App entfernt, wird die Verknüpfung mit dem entsprechenden Object aufgehoben. Ein Nutzer kann also noch einmal auf die Schaltfläche Zu Google Wallet hinzufügen klicken, um die Verknüpfung ohne ein neues Object wiederherzustellen.
Wenn Sie eine Karte bzw. ein Ticket entwickeln, empfehlen wir, eine neue Object-id zwischen den hinzugefügten Karten/Tickets zu verwenden, da die API nicht noch einmal ein Object einfügt, das einer id entspricht.
Beachten Sie, dass das Object beim Entfernen einer Karte bzw. eines Tickets aus Ihrem Konto nicht verloren geht. Es wird nur die Verknüpfung des Object mit Ihrem Konto aufgehoben und Sie können die Verknüpfung dann wiederherstellen.