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
Bei der Google Wallet API wird ein Objekt verwendet, um die physischen Kundenkarten eines 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 LoyaltyObject repräsentiert, das auf ein LoyaltyClass-Element verweist.
Zum Vereinfachen der Implementierung von Änderungen, die auf alle Kundenkarten angewendet werden müssen, verweist jedes Objekt auf eine Klasse.
Eine Klasse enthält gemeinsame Daten für verschiedene Objekte. Beispielsweise speichert LoyaltyClass den programName, während LoyaltyObject die accountId 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 verwendet das Konzept eines Object, um eine Kundenkarte darzustellen. Ein LoyaltyObject-Objekt repräsentiert beispielsweise jede Kundenkarte, die ein Nutzer in seiner Google Wallet App hat.
Nachdem ein Nutzer auf die Schaltfläche Zu Google Wallet hinzufügen geklickt hat, um eine Kundenkarte hinzuzufügen, fügt die API ein Object ein, 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.