Como as classes e os objetos funcionam

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 ofertas físicas 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 um usuário no app Carteira do Google é representada por um OfferObject, que faz referência a um OfferClass.

Para facilitar a implementação de mudanças que precisam ser aplicadas a todas as ofertas, cada objeto faz referência a uma classe.

Uma classe contém dados comuns entre objetos. Por exemplo, OfferClass armazena o redemptionChannel, enquanto OfferObject armazena o barcode 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 uma oferta. Por exemplo, OfferObject representa cada oferta 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 uma oferta, 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 de novo, 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.