Atualizar um cartão de fidelidade

Depois da criação dos cartões, as atualizações são uma maneira importante de interagir com os usuários. Por exemplo, ao atualizar os pontos do cartão de fidelidade de um usuário durante o resgate.

Para atualizar a forma como os cartões são exibidos, como quando o logotipo muda, só é preciso update ou patch a classe do cartão de fidelidade ou usar o Console do Google Pay e da Carteira. O Google propaga essas informações para cada objeto de cartão de fidelidade associado à classe atualizada do cartão. Esse é o caso de todos os campos definidos no nível da classe do cartão de fidelidade.

Para atualizar um único cartão, por exemplo, quando o saldo de pontos do cartão de fidelidade é alterado, é preciso atualizar ou corrigir um único objeto de cartão de fidelidade. Esse é o caso de todos os campos definidos no nível do objeto de cartão de fidelidade.

Observação:

Toda lógica de atualização precisa começar com uma solicitação GET para recuperar a classe ou o objeto. Isso garante que a versão mais recente da classe ou do objeto seja usada. Os campos omitidos são apagados.

Em geral, é muito mais seguro usar o patch quando você fornece dados apenas para os campos que quer alterar. Os campos omitidos não são apagados. No entanto, é preciso ter muito cuidado ao modificar as matrizes. As solicitações de patch que contêm matrizes também substituem a matriz atual pela fornecida por você. Não é possível modificar, adicionar ou excluir parcialmente os itens em uma matriz.

Às vezes, você não sabe quando acontece uma mudança ou quando acionar uma atualização ou solicitação de patch. Nesses casos, programe periodicamente solicitações de atualização ou patch para cada classe e objeto. Para encontrar todas as classes de uma determinada conta de emissor, chame o método da lista de classes de fidelidade. Para encontrar todos os objetos de uma classe específica, chame o método da lista de objetos de fidelidade.