Atualizar um vale-presente

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 vale-presente 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 vale-presente ou usar o Console do Google Pay e da Carteira. O Google propaga essas informações para todos os objetos de vale-presente associados à classe de vale-presente atualizada. Esse é o caso de todos os campos definidos no nível da classe do vale-presente.

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

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 solicitações de atualização ou patch periódicas para cada classe e objeto. Para encontrar todas as classes de uma determinada conta emissora, chame o método de lista de classes de vale-presente. É possível encontrar todos os objetos de uma classe específica ao chamar o método de lista de classes de vale-presente.