REST Resource: flightclass

Recurso: FlightClass

Representação JSON
{
  "kind": string,
  "localScheduledDepartureDateTime": string,
  "localEstimatedOrActualDepartureDateTime": string,
  "localBoardingDateTime": string,
  "localScheduledArrivalDateTime": string,
  "localEstimatedOrActualArrivalDateTime": string,
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "flightStatus": enum (FlightStatus),
  "boardingAndSeatingPolicy": {
    object (BoardingAndSeatingPolicy)
  },
  "localGateClosingDateTime": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "languageOverride": string,
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#flightClass".

localScheduledDepartureDateTime

string

Obrigatório. Data e hora programadas para a partida da aeronave do portão (não da pista)

Observação: não altere este campo muito próximo ao horário de partida. Para atualizações de horários de partida (atrasos etc.), defina localEstimatedOrActualDepartureDateTime.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se a compensação de UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de partida.

localEstimatedOrActualDepartureDateTime

string

O horário estimado para a saída da aeronave do portão ou o horário real em que a aeronave já saiu do portão. Observação: não é o tempo de permanência na pista.

Este campo precisa ser definido se pelo menos uma das situações abaixo for verdadeira:

  • Difere do horário programado. O Google o utilizará para calcular o atraso.
  • A aeronave já saiu do portão. O Google o utilizará para informar ao usuário quando o voo realmente partiu.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se uma compensação UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de partida.

localBoardingDateTime

string

O horário do embarque, como seria impresso no cartão de embarque.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se uma compensação UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de partida.

localScheduledArrivalDateTime

string

O horário programado para a aeronave chegar ao portão de destino (não à pista).

Observação: não altere este campo muito próximo ao horário do voo. Para atualizações de horários de partida (atrasos etc.), defina localEstimatedOrActualArrivalDateTime.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se uma compensação UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de chegada.

localEstimatedOrActualArrivalDateTime

string

O horário estimado para a aeronave alcançar o portão de destino (não a pista) ou o tempo real em que alcançou o portão.

Esse campo precisa ser definido se pelo menos uma das situações abaixo for verdadeira:

  • Difere do horário programado. O Google o utilizará para calcular o atraso.
  • A aeronave já chegou no portão. O Google o utilizará para informar ao usuário que o voo chegou no portão.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se uma compensação UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de chegada.

flightHeader

object (FlightHeader)

Obrigatório. Informações sobre a companhia aérea e o número.

origin

object (AirportInfo)

Obrigatório. Aeroporto de origem.

destination

object (AirportInfo)

Obrigatório. Aeroporto de destino.

flightStatus

enum (FlightStatus)

Status deste voo.

Se não estiver definido, o Google vai calcular o status com base em dados de outras fontes, como FlightStats etc.

Observação: o status calculado pelo Google não será retornado nas respostas de API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Políticas de embarque e assento. Informam quais rótulos serão mostrados aos usuários.

localGateClosingDateTime

string

O horário de fechamento do portão, como seria impresso no cartão de embarque. Não defina este campo se não quiser imprimi-lo no cartão de embarque.

É uma data/hora em formato estendido ISO 8601, sem compensação. O horário pode ser especificado com precisão de milissegundos.

Por exemplo: 2027-03-05T06:30:00

Precisa ser a data/hora local no aeroporto (não um horário UTC).

O Google rejeitará a solicitação se a compensação de UTC for fornecida. Os fusos horários serão calculados pelo Google com base no aeroporto de partida.

classTemplateInfo

object (ClassTemplateInfo)

Informações de modelo sobre como a classe deve ser exibida. Se não estiver definido, o Google vai usar um conjunto padrão de campos a serem exibidos.

languageOverride

string

Se este campo estiver presente, os cartões de embarque exibidos no dispositivo de um usuário sempre estarão neste idioma. Representa a tag de idioma BCP 47. Exemplos de valores: "en-US", "en-GB", "de" ou "de-AT".

id

string

Obrigatório. O identificador exclusivo de uma classe. Esse ID precisa ser exclusivo entre todas as classes de um emissor. Esse valor precisa seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você. O identificador exclusivo deve incluir apenas caracteres alfanuméricos, '.', '_' ou '-'.

version
(deprecated)

string (int64 format)

Suspenso

issuerName

string

Obrigatório. O nome do emissor. O tamanho máximo recomendado é 20 caracteres, para garantir que a string inteira seja exibida em telas menores.

messages[]

object (Message)

Uma matriz de mensagens exibidas no app. Todos os usuários do objeto receberão as mensagens associadas. O número máximo destes campos é 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleto. Use multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

O URI da página inicial do seu aplicativo. Preencher o URI neste campo resulta no mesmo comportamento que o preenchimento de um URI em linksModuleData: quando um objeto é renderizado, um link para a página inicial é mostrado no que normalmente seria considerado a seção linksModuleData do objeto.

locations[]
(deprecated)

object (LatLongPoint)

Observação: no momento, esse campo não é compatível com o acionamento de notificações geográficas.

reviewStatus

enum (ReviewStatus)

Obrigatório. O status da classe. Este campo pode ser definido como draft ou underReview usando as chamadas de inserção, correção ou atualização de API. Depois que o estado da avaliação for alterado de draft, ele não poderá ser alterado de volta para draft.

Mantenha este campo como draft quando a classe estiver em desenvolvimento. Não é possível usar uma classe draft para criar nenhum objeto.

Defina este campo como underReview quando acreditar que a classe está pronta para uso. A plataforma definirá automaticamente esse campo como approved, e ele poderá ser usado imediatamente para criar ou migrar objetos.

Ao atualizar uma classe já approved, continue definindo este campo como underReview.

review

object (Review)

Os comentários de revisão definidos pela plataforma quando uma classe é marcada como approved ou rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Obsoleto. Use textModulesData.

imageModulesData[]

object (ImageModuleData)

Dados do módulo de imagem. O número máximo de campos exibidos é 1 no nível do objeto e 1 no nível do objeto da classe.

textModulesData[]

object (TextModuleData)

Dados do módulo de texto. Se os dados do módulo de texto também estiverem definidos na classe, ambos serão exibidos. O número máximo de campos exibidos é 10 para o objeto e 10 para a classe.

redemptionIssuers[]

string (int64 format)

Identifica quais emissores de resgate podem resgatar o cartão pelo Toque inteligente. Os emissores de resgate são identificados pelo ID do emissor. Os emissores de resgate precisam ter pelo menos uma chave do Toque inteligente configurada.

Os campos enableSmartTap e smartTapRedemptionLevel no nível do objeto também precisam ser configurados corretamente para que o cartão ofereça suporte ao Toque inteligente.

countryCode

string

Código do país usado para mostrar o país do cartão (quando o usuário não está nesse país), bem como para mostrar o conteúdo localizado quando o conteúdo não está disponível na localidade do usuário

heroImage

object (Image)

Imagem de banner opcional exibida na frente do cartão. Se não houver nenhuma, nada será exibido. A imagem será exibida com 100% de largura.

wordMark
(deprecated)

object (Image)

Obsoleto.

enableSmartTap

boolean

Identifica se essa classe oferece suporte ao Toque inteligente. Os campos redemptionIssuers e smartTapRedemptionLevel no nível do objeto também precisam ser configurados corretamente para que o cartão ofereça suporte ao Toque inteligente.

hexBackgroundColor

string

A cor de fundo do card. Se não estiver definida, a cor predominante da imagem principal será usada. Se não houver nenhuma imagem principal definida, a cor predominante do logotipo será usada. O formato é #rrggbb, em que rrggbb é um trio hexadecimal RGB, como #ffcc00. Também é possível usar a versão abreviada do trio RGB, que é #rgb, como #fc0.

localizedIssuerName

object (LocalizedString)

Strings traduzidas do issuerName. O tamanho máximo recomendado é 20 caracteres, para garantir que a string inteira seja exibida em telas menores.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifica se vários usuários e dispositivos vão salvar o mesmo objeto que faz referência a esta classe.

callbackOptions

object (CallbackOptions)

Opções de callback a serem usadas para retornar ao emissor em cada salvamento/exclusão de um objeto desta classe pelo usuário final. Todos os objetos desta classe são qualificados para callback.

securityAnimation

object (SecurityAnimation)

Informações opcionais sobre a animação de segurança. Se essa opção for definida, uma animação de segurança será renderizada nos detalhes do cartão.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Confira as opções de requisito de desbloqueio para o cartão de embarque.

notifyPreference

enum (NotificationSettingsForUpdates)

Se as atualizações de campo para essa classe precisam acionar notificações. Quando definida como NOTIFY, tentaremos acionar uma notificação de atualização de campo para os usuários. Essas notificações só serão enviadas aos usuários se o campo fizer parte de uma lista de permissões. Se não for especificado, nenhuma notificação será acionada. Essa configuração é temporária e precisa ser definida em cada solicitação PATCH ou UPDATE. Caso contrário, a notificação não será acionada.

valueAddedModuleData[]

object (ValueAddedModuleData)

Dados opcionais do módulo de valor agregado. Máximo de dez na classe. Para um cartão, apenas dez serão exibidos, priorizando os valores do objeto.

FlightHeader

Representação JSON
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#flightHeader".

carrier

object (FlightCarrier)

Informações sobre a transportadora aérea. Esta é uma propriedade obrigatória de flightHeader.

flightNumber

string

O número do voo sem o código IATA da transportadora. Este campo deve conter apenas dígitos. Esta é uma propriedade obrigatória de flightHeader.

Por exemplo, "123".

operatingCarrier

object (FlightCarrier)

Informações sobre a companhia aérea operadora.

operatingFlightNumber

string

O número de voo usado pela operadora sem o código IATA da transportadora. Este campo deve conter apenas dígitos.

Por exemplo: "234"

flightNumberDisplayOverride

string

Valor de substituição a ser usado para o número do voo. O valor padrão usado para fins de exibição é "transporte" + "flightNumber". Se um valor diferente precisar ser mostrado aos passageiros, use esse campo para substituir o comportamento padrão.

Por exemplo: "XX1234 / YY576"

FlightCarrier

Representação JSON
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#flightCarrier".

carrierIataCode

string

Código IATA da companhia aérea, com dois caracteres, da transportadora de marketing (diferente da operadora). É preciso que exatamente um código deste ou carrierIcaoCode seja fornecido para carrier e operatingCarrier.

Por exemplo: "LX" para Swiss Air.

carrierIcaoCode

string

Código ICAO da companhia aérea, com três caracteres, da transportadora de marketing (não da operadora). É preciso que exatamente um código deste ou carrierIataCode seja fornecido para carrier e operatingCarrier.

Por exemplo: "EZY" para Easy Jet.

airlineName

object (LocalizedString)

Um nome localizado da companhia aérea especificado por carrierIataCode. Se não for definido, issuerName ou localizedIssuerName de FlightClass serão usados para fins de exibição.

Por exemplo: "Swiss Air" para "LX".

AirportInfo

Representação JSON
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#airportInfo".

airportIataCode

string

Código IATA do aeroporto, com três caracteres. Este é um campo obrigatório para origin e destination.

Por exemplo: "SFO".

terminal

string

Nome do terminal. Por exemplo: "INTL" ou "I".

gate

string

Um nome do portão. Por exemplo: "B59" ou "59".

airportNameOverride

object (LocalizedString)

Campo opcional que modifica o nome da cidade do aeroporto definido pela IATA. Por padrão, o Google pega o airportIataCode fornecido e o mapeia para o nome oficial da cidade do aeroporto definido pela IATA.

Os nomes oficiais IATA das cidades de aeroportos podem ser encontrados no site IATA airport city names (em inglês). Por exemplo, para o código IATA do aeroporto "LTN", o site da IATA informa que a cidade correspondente é "Londres".

Se este campo não for preenchido, o Google exibirá "Londres".

No entanto, se o campo for preenchido com um nome personalizado (por exemplo, "Londres Luton"), ele será substituído.

FlightStatus

Enums
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED O voo está no horário, antecipado ou atrasado.
scheduled

Alias legado de SCHEDULED. Obsoleto.

ACTIVE O voo está em andamento (taxiando, decolando, aterrissando, no ar).
active

Alias legado de ACTIVE. Obsoleto.

LANDED O voo pousou no destino original.
landed

Alias legado de LANDED. Obsoleto.

CANCELLED O voo foi cancelado.
cancelled

Alias legado de CANCELLED. Obsoleto.

REDIRECTED O voo está no ar, mas indo para um aeroporto diferente do destino original.
redirected

Alias legado de REDIRECTED. Obsoleto.

DIVERTED O voo já pousou em um aeroporto diferente do destino original.
diverted

Alias legado de DIVERTED. Obsoleto.

BoardingAndSeatingPolicy

Representação JSON
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#boardingAndSeatingPolicy".

boardingPolicy

enum (BoardingPolicy)

Indica a política que a companhia aérea usa para o embarque. Se não estiver definido, o Google usará zoneBased como padrão.

seatClassPolicy

enum (SeatClassPolicy)

Política de assentos que determina como exibimos a classe de assentos. Se não estiver definido, o Google usará cabinBased como padrão.

BoardingPolicy

Enums
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Alias legado de ZONE_BASED. Obsoleto.

GROUP_BASED
groupBased

Alias legado de GROUP_BASED. Obsoleto.

BOARDING_POLICY_OTHER
boardingPolicyOther

Alias legado de BOARDING_POLICY_OTHER. Obsoleto.

SeatClassPolicy

Enums
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Alias legado de CABIN_BASED. Obsoleto.

CLASS_BASED
classBased

Alias legado de CLASS_BASED. Obsoleto.

TIER_BASED
tierBased

Alias legado de TIER_BASED. Obsoleto.

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

Alias legado de SEAT_CLASS_POLICY_OTHER. Obsoleto.

Métodos

addmessage

Adiciona uma mensagem à classe de voo indicada pelo ID de classe fornecido.

get

Retorna a classe de voo com o ID de classe fornecido.

insert

Insere uma classe de voo com o ID e as propriedades fornecidos.

list

Retorna uma lista de todas as classes de voo de um determinado ID de emissor.

patch

Atualiza a classe de voo indicada pelo ID de classe fornecido.

update

Atualiza a classe de voo indicada pelo ID de classe fornecido.