Ресурс REST: flightclass

Ресурс: FlightClass

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)
  }
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#flightClass".

localScheduledDepartureDateTime

string

Обязательно. Запланированные дата и время отбытия самолета от терминала (не время взлета).

Примечание. Время, указанное в этом поле, не должно быть слишком приближено к времени вылета. Чтобы обновить расписание (в случае задержек и т. п.), воспользуйтесь полем localEstimatedOrActualDepartureDateTime.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта вылета.

localEstimatedOrActualDepartureDateTime

string

Расчетное или фактическое время отбытия самолета от терминала. Обратите внимание, что это не время взлета.

Данное поле должно быть заполнено, если выполняется хотя бы одно из следующих условий:

  • Это время отличается от запланированного. На его основе будет рассчитываться задержка.
  • Самолет уже отбыл от терминала. Google информирует пользователей об отбытии рейса.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта вылета.

Если время не задано, Google установит его на основе данных из других источников.

localBoardingDateTime

string

Время посадки, которое будет указано на посадочном талоне.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта вылета.

Если время не задано, Google установит его на основе данных из других источников.

localScheduledArrivalDateTime

string

Запланированное время прибытия самолета к терминалу назначения (не время посадки).

Примечание. Время, указанное в этом поле, не должно быть слишком приближено к времени прилета. Чтобы обновить расписание (в случае задержек и т. п.), воспользуйтесь полем localEstimatedOrActualArrivalDateTime.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта прибытия.

Если время не задано, Google установит его на основе данных из других источников.

localEstimatedOrActualArrivalDateTime

string

Расчетное или фактическое время прибытия самолета к терминалу (не время приземления).

Данное поле должно быть заполнено, если выполняется хотя бы одно из следующих условий:

  • Это время отличается от запланированного. На его основе будет рассчитываться задержка.
  • Самолет уже прибыл к терминалу. Google информирует пользователей о прибытии рейса.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта прибытия.

Если время не задано, Google установит его на основе данных из других источников.

flightHeader

object (FlightHeader)

Обязательно. Название авиакомпании и номер рейса.

origin

object (AirportInfo)

Обязательно. Аэропорт отправления.

destination

object (AirportInfo)

Обязательно. Аэропорт прибытия.

flightStatus

enum (FlightStatus)

Статус рейса.

Если статус не задан, Google установит его на основе данных из других источников, например FlightStats.

Обратите внимание, что установленный таким образом статус не возвращается в ответах API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Правила в отношении посадки и рассадки пассажиров. Они определяют, какие ярлыки будут показаны пользователям.

localGateClosingDateTime

string

Время окончания посадки, которое будет указано на посадочном талоне. Если вы не хотите указывать данную информацию на посадочном талоне, не заполняйте это поле.

Дата и время без смещения в расширенном формате ISO 8601. Время может быть указано с точностью до миллисекунды.

Пример: 2027-03-05T06:30:00

Здесь следует указывать не всемирное координированное время (UTC), а местное время и дату.

Google отклонит запрос, если указать смещение относительно UTC. Часовые пояса будут рассчитаны на основе местоположения аэропорта вылета.

classTemplateInfo

object (ClassTemplateInfo)

Информация в шаблоне о том, как должен отображаться класс. Если этот объект не задан, то будет использоваться набор полей по умолчанию.

languageOverride

string

Если есть это поле, то все проездные билеты на устройстве пользователя будут отображаться на этом языке. Представляет собой языковой тег BCP 47. Примеры значений: en-US, en-GB, de, de-AT.

id

string

Обязательно. Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: идентификатор эмитента.ваш идентификатор. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, символы подчеркивания и дефисы.

version
(deprecated)

string (int64 format)

Больше не используется

issuerName

string

Обязательно. Название эмитента. Рекомендуемая длина для корректного отображения на небольших экранах: максимум 20 символов.

messages[]

object (Message)

Массив сообщений, которые будут отображаться в приложении. Связанные с ним сообщения увидят все пользователи этого объекта. Максимальное число полей – 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Вместо него используйте multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

URI главной страницы приложения. Если вы заполните это поле, то результат будет тот же, что и при указании URI в поле linksModuleData: ссылка на главную страницу появится в разделе linksModuleData отображаемого объекта.

locations[]

object (LatLongPoint)

reviewStatus

enum (ReviewStatus)

Обязательно. Статус класса. Задать значение draft или underReview можно через вызовы API с помощью методов insert, patch или update. Обратите внимание, что после изменения статуса draft на любой другой вернуть значение draft невозможно.

Пока класс остается на этапе разработки, для него должен быть указан статус draft. На стадии draft нельзя создавать объекты.

Когда класс будет готов для проверки, необходимо изменить значение поля на underReview. Если класс будет одобрен, статус автоматически изменится на approved. После этого класс можно будет использовать для создания и перемещения объектов.

Если вы захотите обновить класс со статусом approved, значение поля нужно будет изменить на underReview.

review

object (Review)

Комментарий о проверке, который платформа устанавливает, когда классу присваивается отметка approved или rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Вместо него используйте textModulesData.

imageModulesData[]

object (ImageModuleData)

Данные графического модуля. Отображается не более 1 поля из уровня объекта и 1 поля для уровня объекта класса.

textModulesData[]

object (TextModuleData)

Данные текстового модуля. Если для класса также задан текстовый модуль, то показываться будут оба. Отображается не более 10 полей из объекта и 10 полей из класса.

redemptionIssuers[]

string (int64 format)

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.

countryCode

string

Код страны, по которому определяется место выпуска карты. Используется, когда пользователь совершает покупки в другой стране. Этот код также необходим для показа локализованного контента, если оригинальный контент недоступен в регионе пользователя.

heroImage

object (Image)

Дополнительный баннер, который отображается на лицевой стороне карты. Показывается только при наличии. Занимает всю ширину карты.

wordMark
(deprecated)

object (Image)

Больше не используется.

enableSmartTap

boolean

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.

hexBackgroundColor

string

Цвет фона карты. Если он не задан, то для оформления фона будет использован преобладающий цвет главного изображения, а в случае отсутствия изображения – логотипа. Используется формат #rrggbb, где rrggbb – код цвета RGB в шестнадцатеричном формате, например #ffcc00. Также можно использовать сокращенную версию в формате #rgb, например #fc0.

localizedIssuerName

object (LocalizedString)

Варианты поля issuerName на других языках. Рекомендуемая длина для корректного отображения на небольших экранах: максимум 20 символов.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Определяет, будет ли один и тот же объект сохраняться у разных пользователей и устройств, ссылающихся на этот класс.

callbackOptions

object (CallbackOptions)

Параметры обратного вызова, которые будут использоваться для вызова эмитента всякий раз, когда конечные пользователи станут сохранять или удалять объекты этого класса. Данная функция доступна для всех объектов в этом классе.

FlightHeader

JSON-представление

{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#flightHeader".

carrier

object (FlightCarrier)

Информация об авиакомпании. Это необходимое свойство объекта flightHeader.

flightNumber

string

Номер рейса без кода авиакомпании IATA. Может содержать только цифры. Это необходимое свойство объекта flightHeader.

Пример: "123".

operatingCarrier

object (FlightCarrier)

Информация о фактическом перевозчике.

operatingFlightNumber

string

Номер рейса, используемый фактическим перевозчиком, без кода авиакомпании IATA. Может содержать только цифры.

Пример: "234"

FlightCarrier

JSON-представление

{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  }
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#flightCarrier".

carrierIataCode

string

Двухбуквенное обозначение маркетингового (а не фактического) перевозчика по системе IATA. В полях carrier и operatingCarrier должен быть указан один из этих кодов или carrierIcaoCode.

Пример: код "LX" для авиакомпании Swiss Air.

carrierIcaoCode

string

Трехбуквенное обозначение маркетингового (а не фактического) перевозчика по системе ICAO. В полях carrier и operatingCarrier должен быть указан один из этих кодов или carrierIataCode.

Пример: код "EZY" для авиакомпании Easy Jet.

airlineName

object (LocalizedString)

Локализованное название авиакомпании, обозначенной кодом carrierIataCode. Если не задано, отображаться будет issuerName или localizedIssuerName из объекта FlightClass.

Пример: "Швейцарские авиалинии" для "LX".

AirportInfo

JSON-представление

{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#airportInfo".

airportIataCode

string

Трехзначный код аэропорта по системе IATA. Обязательное поле для origin и destination.

Пример: "SFO".

terminal

string

Название терминала. Пример: "INTL" или "I".

gate

string

Название выхода. Пример: "B59" или "59".

airportNameOverride

object (LocalizedString)

Дополнительное поле, которое переопределяет название города/аэропорта, закодированного по системе IATA. По умолчанию Google берет предоставленный код airportIataCode, определяет официальное название города/аэропорта в системе IATA и выводит его.

Официальные названия городов/аэропортов можно найти на сайте IATA. Например, согласно сайту IATA, код "LTN" соответствует Лондону.

Если это поле не заполнено, то будет показано значение "London".

Если в этом поле указано значение, например "Лондон Лутон", то будет показано оно.

FlightStatus

Перечисления
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED Отправление рейса (по расписанию, с опережением или с задержкой).
scheduled

Устаревшее название элемента SCHEDULED.

ACTIVE Выполнение рейса (руление, взлет, полет, посадка).
active

Устаревшее название элемента ACTIVE.

LANDED Посадка в первоначальном пункте назначения.
landed

Устаревшее название элемента LANDED.

CANCELLED Отмена рейса.
cancelled

Устаревшее название элемента CANCELLED.

REDIRECTED Самолет в воздухе, но направляется не в первоначальный пункт назначения, а в другой аэропорт.
redirected

Устаревшее название элемента REDIRECTED.

DIVERTED Самолет приземлился, но не в первоначальном пункте назначения, а в другом аэропорте.
diverted

Устаревшее название элемента DIVERTED.

BoardingAndSeatingPolicy

JSON-представление

{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#boardingAndSeatingPolicy".

boardingPolicy

enum (BoardingPolicy)

Правила посадки, принятые в авиакомпании. По умолчанию используется значение zoneBased.

seatClassPolicy

enum (SeatClassPolicy)

Правила рассадки, определяющие способ отображения класса авиабилета. По умолчанию используется значение cabinBased.

BoardingPolicy

Перечисления
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Устаревший псевдоним элемента ZONE_BASED.

GROUP_BASED
groupBased

Устаревший псевдоним элемента GROUP_BASED.

BOARDING_POLICY_OTHER
boardingPolicyOther

Устаревший псевдоним элемента BOARDING_POLICY_OTHER.

SeatClassPolicy

Перечисления
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Устаревший псевдоним элемента CABIN_BASED.

CLASS_BASED
classBased

Устаревший псевдоним элемента CLASS_BASED.

TIER_BASED
tierBased

Устаревший псевдоним элемента TIER_BASED.

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

Устаревший псевдоним элемента SEAT_CLASS_POLICY_OTHER.

Методы

addmessage

Добавляет сообщение к классу flight с указанным идентификатором.

get

Возвращает класс flight, к которому относится указанный идентификатор.

insert

Добавляет класс flight с заданными идентификатором и свойствами.

list

Возвращает список всех классов типа flight, которые относятся к указанному идентификатору эмитента.

patch

Обновляет класс flight с указанным идентификатором.

update

Обновляет класс flight с указанным идентификатором.