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 cartões de fidelidade físicos de um 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 um usuário no app Carteira do Google é representada
por um LoyaltyObject, que refere-se a um LoyaltyClass.
Para facilitar a implementação de mudanças que precisam ser aplicadas a todos os vales-presente, cada objeto refere-se a uma classe.
Uma classe contém dados comuns entre objetos. Por exemplo,
LoyaltyClass armazena o programName, enquanto
LoyaltyObject armazena o accountId 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 Object para representar
um cartão de fidelidade. Por exemplo, um LoyaltyObject representa cada
cartão de fidelidade do usuário no app Carteira do Google.
Depois que um usuário clica no botão Adicionar à Carteira do Google para adicionar um cartão de fidelidade, 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.