Recurso REST: 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)
  }
}
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 uma compensação 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 deverá 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.

Se não estiver definido, o Google o definirá com base nos dados de outras fontes.

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.

Se não estiver definido, o Google o definirá com base nos dados de outras fontes.

localScheduledArrivalDateTime

string

O horário programado para a aeronave alcançar o portão de destino (não a 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.

Se não estiver definido, o Google o definirá com base nos dados de outras fontes.

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.

Este campo deverá 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.

Se não estiver definido, o Google o definirá com base nos dados de outras fontes.

flightHeader

object (FlightHeader)

Obrigatório. Informações sobre a transportadora 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 do voo.

Se não estiver definido, o Google 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 uma compensação 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 usará como alternativa 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. Valores de exemplo: "en-US", "en-GB", "de" ou "de-AT".

id

string

Obrigatório. O identificador exclusivo de uma classe. Este 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 último é escolhido por você. O identificador exclusivo deve incluir apenas caracteres alfanuméricos: ".", "_" ou "-".

version
(deprecated)

string (int64 format)

Obsoleto

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)

Um conjunto de mensagens exibidas no app. Todos os usuários deste 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[]

object (LatLongPoint)

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 revisão for alterado de draft, ele não será alterado novamente para draft.

Você precisa manter esse campo como draft quando a classe estiver em desenvolvimento. Não é possível usar uma classe draft para criar nenhum objeto.

Quando acreditar que a classe está pronta para uso, defina este campo como underReview. 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, é preciso continuar configurando 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 esses dados 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)

Disponível apenas para parceiros que aceitam smart tap. Entre em contato com o suporte para mais orientações.

countryCode

string

ID do país, usado para exibir o país do cartão (quando o usuário não está nesse país), bem como para exibir 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

Disponível apenas para parceiros que aceitam smart tap. Entre em contato com o suporte para mais orientações.

hexBackgroundColor

string

A cor de fundo do cartão. 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 salvarão 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.

FlightHeader

Representação JSON

{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": 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 operadora aérea.

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".

FlightCarrier

Representação JSON

{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    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, como 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 (diferente 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 da IATA (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, preencher este campo com um nome personalizado (por exemplo: "London Luton") modifica o valor.

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 curso (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 de embarque da companhia aérea. Se não estiver definido, o Google usará zoneBased como padrão.

seatClassPolicy

enum (SeatClassPolicy)

Política de assento que determina como exibimos a classe de assento. 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 código de classe fornecido.

get

Retorna a classe de voo com o código de classe fornecido.

insert

Insere uma classe de voo com o código e as propriedades fornecidos.

list

Retorna uma lista de todas as classes de voo de um determinado código de emissor.

patch

Atualiza a classe de voo indicada pelo código de classe fornecido.

update

Atualiza a classe de voo indicada pelo código de classe especificado.