Nesta página, vamos descrever a relação entre classes e objetos, que é fundamental para o funcionamento da API Google Wallet. Também vamos abordar como os objetos são vinculados aos usuários.
Classes e objetos
A API Google Wallet usa o conceito de objeto para representar digitalmente os cartões de transporte público de um único usuário. A API usa o conceito de classe para permitir o gerenciamento de dados comuns entre todos os usuários. Para abordar casos de uso específicos, cada indústria tem um objeto e uma classe próprios.
Por exemplo, cada carteira de usuário no app Carteira do Google é representada
por um TransitObject, que
faz referência a um TransitClass.
Para facilitar a implementação de mudanças que precisam ser aplicadas a todos os cartões de transporte público, cada objeto refere-se a uma classe.
Uma classe contém dados comuns entre objetos. Por exemplo,
TransitClass armazena o transitType, enquanto
TransitObject armazena o ticketNumber de uma pessoa.
A relação entre classe e objeto pode ser de um para um, mas uma classe pode ser referenciada por muitos
objetos.
As mudanças feitas na classe ou no objeto se propagam imediatamente. Os usuários podem ver essas alterações no app Carteira do Google quando fazem a sincronização.
Objetos e vinculação
A API Google Wallet usa o conceito de um Object para representar
um cartão de transporte público. Por exemplo, um TransitObject representa cada
transporte público que um usuário tem no app Carteira do Google.
Depois que um usuário clica no botão Adicionar à Carteira do Google para adicionar um cartão de transporte público, a
API insere um Object que estabelece um link entre o objeto e o usuário. Isso
significa que, quando o usuário clicar no botão novamente, já vai existir um link para Object.
Se o usuário remover o cartão do app Carteira do Google, o link para o Object
correspondente será removido. Isso significa que o usuário pode clicar novamente no botão
Adicionar à Carteira do Google para restabelecer esse link sem um novo
Object.
Durante o desenvolvimento do seu cartão, recomendamos que você use um
Object id novo entre as adições, porque a API não insere novamente um
Object que corresponde a id.
Lembre-se de que, ao remover um cartão da sua conta, você não perde o
Object. O Object só será desvinculado da sua conta e poderá ser vinculado
novamente.