Cette page décrit la relation entre les classes et les objets, qui est essentielle au fonctionnement de l'API Google Wallet. Cette page explique également comment les objets sont associés aux utilisateurs.
Classes et objets
L'API Google Wallet utilise le concept d'objet pour représenter numériquement les titres de transport d'un seul utilisateur. L'API utilise le concept de classe pour permettre la gestion des données communes à tous les utilisateurs. Pour couvrir des cas d'utilisation spécifiques, chaque type a son propre objet et sa propre classe.
Par exemple, chaque compte Google Wallet dont dispose un utilisateur dans son application Google Wallet est représenté par un TransitObject, qui fait référence à une TransitClass.
Pour faciliter la mise en œuvre des modifications devant s'appliquer à tous les titres de transport, chaque objet fait référence à une classe.
Une classe contient des données communes à tous les objets. Par exemple, TransitClass stocke le transitType, tandis que TransitObject stocke le ticketNumber d'une personne physique.
La relation entre classe et objet peut être de type un à un, mais une classe peut être référencée par plusieurs objets.
Les modifications apportées à la classe ou à l'objet sont immédiatement appliquées. Les utilisateurs peuvent voir ces modifications dans l'application Google Wallet lorsqu'ils effectuent une synchronisation.
Objets et liens
L'API Google Wallet utilise le concept de Object pour représenter les titres de transport. Par exemple, un TransitObject représente chaque titre de transport dont dispose un utilisateur dans son application Google Wallet.
Lorsqu'un utilisateur clique sur le bouton Ajouter à Google Wallet pour ajouter un titre de transport, l'API insère un Object qui établit un lien entre l'objet et l'utilisateur. Cela signifie que lorsque l'utilisateur clique de nouveau sur le bouton, le lien avec l'Object existe déjà.
Si un utilisateur supprime sa carte de l'application Google Wallet, celle-ci n'est plus associée à l'Object. Cela signifie qu'un utilisateur peut à nouveau cliquer sur le bouton Ajouter à Google Wallet pour rétablir cette association sans avoir de nouvel Object.
Lorsque vous développez votre carte, nous vous recommandons d'utiliser un nouvel id d'Object entre les ajouts, car l'API ne réinsère pas d'Object correspondant à un id.
N'oubliez pas que lorsque vous supprimez une carte de votre compte, vous ne perdez pas votre Object. L'Object est uniquement dissocié de votre compte, et vous pouvez de nouveau l'associer.