Atualizar um cartão de transporte público

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 o saldo do cartão de um usuário para uma compra realizada no app.

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 cartão de transporte público associado à classe de cartão de transporte público atualizada. Esse é o caso de todos os campos definidos no nível da classe do cartão de transporte público.

Para atualizar um único cartão, por exemplo, quando o saldo de pontos de transporte público é alterado, você precisa atualizar ou corrigir um objeto de cartão de transporte público. Esse é o caso de todos os campos definidos no objeto do cartão de transporte público.

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 de emissor, chame o método da lista de classes de transporte público. É possível encontrar todos os objetos de uma determinada classe chamando o método da lista de objetos de transporte público.