Atualizar um cartão de embarque

Depois da criação dos cartões, as atualizações são uma forma importante de interagir com os usuários. Por exemplo, alterar os pontos de cartão de embarque nos cards de usuários à medida que eles resgatam os pontos.

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

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

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 embarque. É possível encontrar todos os objetos de uma determinada classe chamando o método da lista de objetos de embarque.

Fontes de dados para atualizações de voo

Se a hora fornecida por class.localScheduledDepartureDateTime estiver entre as últimas 24 horas ou as próximas 48 horas, um card de status de voo será exibido para os usuários. Quando isso acontece, a Carteira do Google pode exibir dados do Google Voos ou das informações fornecidas no cartão de transporte no app. A fonte a ser usada depende do seguinte:

• Se class.localEstimatedOrActualDepartureDateTime não for fornecido, o Google Voos será usado. Nesse caso, qualquer class.flightStatus definido será ignorado.

  Por exemplo, se um voo estiver atrasado, os usuários verão um card na guia "Página inicial" do app da Carteira do Google que exibirá o novo horário de partida. Um card de atraso semelhante também será exibido para os usuários na guia "Cartões".

• Se você tiver fornecido o class.localEstimatedOrActualDepartureDateTime, mas não o class.flightStatus, a hora fornecida será usada para determinar se um voo está atrasado. O status do voo no card é exibido aos usuários com base na seguinte lógica:
  • Se class.localEstimatedOrActualDepartureDateTime for maior que class.localScheduledDepartureDateTime, os usuários veem um card com o voo listado como atrasado.
  • Se class.localEstimatedOrActualDepartureDateTime não for maior que class.localScheduledDepartureDateTime, os usuários veem o card com as informações de voo, mas sem nenhuma mensagem de status.

Se você não quiser usar o Google Voos como fonte de informações sobre voos, forneça flightStatus, localScheduledDepartureDateTime e localEstimatedOrActualDepartureDateTime da FlightClass. Somente seus dados serão usados no card. Como alternativa, se você usar um código de companhia aérea ICAO em vez de um código IATA em FlightClass, o Google Voos não será usado como fonte de informações de voo.

Quando determinados campos são alterados, o usuário recebe notificações push sobre as alterações. Para mais detalhes, consulte Receber notificações de atualização de voo.