REST Resource: 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)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement)
}
입력란
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#flightClass".

localScheduledDepartureDateTime

string

필수 항목입니다. 항공기가 활주로가 아닌 게이트에서 출발할 예정 날짜 및 시간입니다.

참고: 출발 시간이 임박했을 때 이 입력란을 변경해서는 안 됩니다. 지연 등의 이유로 출발 시간을 업데이트하려면 localEstimatedOrActualDepartureDateTime를 설정하세요.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 출발 공항을 기준으로 시간대를 계산합니다.

localEstimatedOrActualDepartureDateTime

string

항공기가 게이트에서 출발할 예상 시간 또는 항공기가 게이트에서 출발한 실제 시간입니다. 참고: 이 시간은 활주로 시간이 아닙니다.

다음 중 하나 이상에 해당되는 경우 이 필드를 설정해야 합니다.

  • 예정된 시간과 다릅니다. Google에서는 이 값을 사용하여 지연 시간을 계산합니다.
  • 항공기가 이미 게이트에서 출발했습니다. Google은 이 값을 사용하여 항공기가 실제로 출발한 시점을 사용자에게 알립니다.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 출발 공항을 기준으로 시간대를 계산합니다.

설정하지 않으면 Google은 다른 소스의 데이터를 기반으로 설정합니다.

localBoardingDateTime

string

탑승권에 인쇄되는 탑승 시간입니다.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 출발 공항을 기준으로 시간대를 계산합니다.

설정하지 않으면 Google은 다른 소스의 데이터를 기반으로 설정합니다.

localScheduledArrivalDateTime

string

항공기가 활주로가 아닌 목적지 게이트에 도착하기로 예정된 시간입니다.

참고: 비행 시간이 임박했을 때 이 입력란을 변경해서는 안 됩니다. 지연 등의 이유로 출발 시간을 업데이트하려면 localEstimatedOrActualArrivalDateTime를 설정하세요.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 도착 공항을 기준으로 시간대를 계산합니다.

설정하지 않으면 Google은 다른 소스의 데이터를 기반으로 설정합니다.

localEstimatedOrActualArrivalDateTime

string

항공기가 활주로가 아닌 목적지 게이트에 도착할 예상 시간 또는 게이트에 실제로 도착한 시간입니다.

다음 중 하나 이상에 해당되는 경우 이 필드를 설정해야 합니다.

  • 예정된 시간과 다릅니다. Google에서는 이 값을 사용하여 지연 시간을 계산합니다.
  • 항공기가 이미 게이트에 도착했습니다. Google은 이 값을 사용하여 항공기가 게이트에 도착했음을 사용자에게 알립니다.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 도착 공항을 기준으로 시간대를 계산합니다.

설정하지 않으면 Google은 다른 소스의 데이터를 기반으로 설정합니다.

flightHeader

object (FlightHeader)

필수 항목입니다. 항공사 및 항공편 번호에 관한 정보입니다.

origin

object (AirportInfo)

필수 항목입니다. 출발지 공항

destination

object (AirportInfo)

필수 항목입니다. 목적지 공항입니다.

flightStatus

enum (FlightStatus)

이 항공편의 상태입니다.

설정하지 않으면 Google에서 FlightStats 등과 같은 다른 소스의 데이터를 기반으로 상태를 계산합니다.

참고: Google이 계산한 상태는 API 응답에 반환되지 않습니다.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

탑승 및 좌석 정책입니다. 이를 통해 사용자에게 어떤 라벨이 표시될지 알 수 있습니다.

localGateClosingDateTime

string

탑승권에 인쇄되는 게이트 마감 시간입니다. 탑승권에 인쇄하지 않으려면 이 필드를 설정하지 마세요.

오프셋이 없는 ISO 8601 확장 형식 날짜/시간입니다. 시간은 밀리초 단위까지 지정할 수 있습니다.

예: 2027-03-05T06:30:00

UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

UTC 오프셋을 제공하면 Google에서 요청을 거부합니다. Google은 출발 공항을 기준으로 시간대를 계산합니다.

classTemplateInfo

object (ClassTemplateInfo)

클래스가 표시되는 방식에 대한 템플릿 정보입니다. 설정하지 않으면 Google은 표시할 기본 필드 집합으로 대체합니다.

languageOverride

string

이 필드가 있으면 사용자 기기에 제공되는 탑승권은 항상 이 언어로 설정됩니다. BCP 47 언어 태그를 나타냅니다. 값의 예로는 'en-US', 'en-GB', 'de', 'de-AT'가 있습니다.

id

string

필수 항목입니다. 클래스의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 클래스에서 고유해야 합니다. 이 값은 issuer ID 형식을 따라야 합니다.identifier의 경우 전자는 Google에서 발급하며 후자는 개발자가 직접 선택합니다. 고유 식별자에는 영숫자 문자, '.', '_', '-'만 포함되어야 합니다.

version
(deprecated)

string (int64 format)

지원 중단됨

issuerName

string

필수 항목입니다. 발급기관 이름입니다. 전체 문자열이 작은 화면에 표시될 수 있도록 권장되는 최대 길이는 20자(바이트)입니다.

messages[]

object (Message)

앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 연결된 메시지를 수신합니다. 이러한 필드의 최대 개수는 10개입니다.

allowMultipleUsersPerObject
(deprecated)

boolean

지원이 중단되었습니다. 대신 multipleDevicesAndHoldersAllowedStatus를 사용하세요.

homepageUri

object (Uri)

애플리케이션 홈페이지의 URI입니다. 이 필드에 URI를 채우면 linksModuleData에 URI를 채우는 것과 정확히 동일한 동작이 발생합니다 (객체가 렌더링되면 홈페이지 링크가 일반적으로 객체의 linksModuleData 섹션으로 간주되는 부분에 표시됨).

locations[]

object (LatLongPoint)

참고: 이 필드는 현재 지역 알림을 트리거하는 데 지원되지 않습니다.

reviewStatus

enum (ReviewStatus)

필수 항목입니다. 클래스의 상태입니다. 이 필드는 삽입, 패치, 업데이트 API 호출을 사용하여 draft 또는 underReview로 설정할 수 있습니다. 검토 상태가 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)

스마트 탭을 통해 패스를 사용할 수 있는 패스 사용 발급기관을 식별합니다. 패스 사용 발급기관은 발급기관 ID로 식별됩니다. 패스 사용 발급기관에 하나 이상의 스마트 탭 키가 구성되어 있어야 합니다.

패스가 스마트 탭을 지원하려면 enableSmartTap 및 객체 수준 smartTapRedemptionLevel 필드도 올바르게 설정해야 합니다.

countryCode

string

(사용자가 해당 국가에 있지 않을 때) 카드의 국가를 표시하고 사용자의 언어로 콘텐츠를 사용할 수 없을 때 현지화된 콘텐츠를 표시하는 데 사용되는 국가 코드입니다.

heroImage

object (Image)

카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 아무것도 없으면 아무것도 표시되지 않습니다. 이미지는 100% 너비로 표시됩니다.

wordMark
(deprecated)

object (Image)

지원이 중단되었습니다.

enableSmartTap

boolean

이 클래스가 스마트 탭을 지원하는지 여부를 식별합니다. 패스가 스마트 탭을 지원하려면 redemptionIssuers 및 객체 수준 smartTapRedemptionLevel 필드도 올바르게 설정해야 합니다.

hexBackgroundColor

string

카드의 배경 색상입니다. 설정하지 않으면 히어로 이미지의 주요 색상이 사용되고 설정된 히어로 이미지가 없으면 로고의 주요 색상이 사용됩니다. 형식은 #rrggbb입니다. 여기서 rrggbb#ffcc00와 같은 16진수 RGB 3색입니다. #fc0과 같이 #rgb인 RGB 3색의 축약 버전을 사용할 수도 있습니다.

localizedIssuerName

object (LocalizedString)

발급기관Name의 번역된 문자열입니다. 전체 문자열이 작은 화면에 표시될 수 있도록 권장되는 최대 길이는 20자(바이트)입니다.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

여러 사용자 및 기기가 이 클래스를 참조하는 동일한 객체를 저장할지 여부를 식별합니다.

callbackOptions

object (CallbackOptions)

최종 사용자가 이 클래스의 객체를 저장/삭제할 때마다 발급기관을 다시 호출하는 데 사용되는 콜백 옵션입니다. 이 클래스의 모든 객체에는 콜백이 적용됩니다.

securityAnimation

object (SecurityAnimation)

보안 애니메이션에 대한 선택적 정보입니다. 설정되면 패스 세부정보에 보안 애니메이션이 렌더링됩니다.

viewUnlockRequirement

enum (ViewUnlockRequirement)

탑승권의 잠금 해제 요구사항 옵션을 확인합니다.

FlightHeader

JSON 표현
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
입력란
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#flightHeader".

carrier

object (FlightCarrier)

항공사에 대한 정보입니다. flightHeader의 필수 속성입니다.

flightNumber

string

IATA 항공사 코드가 없는 항공편 번호입니다. 이 필드에는 숫자만 포함되어야 합니다. flightHeader의 필수 속성입니다.

예: '123'

operatingCarrier

object (FlightCarrier)

운항 항공사에 대한 정보입니다.

operatingFlightNumber

string

운항 항공사에서 사용하며 IATA 항공사 코드 없이 항공편 번호입니다. 이 필드에는 숫자만 포함되어야 합니다.

예: '234'

flightNumberDisplayOverride

string

항공편 번호에 사용할 값을 재정의합니다. 표시에 사용되는 기본값은 항공사 +flightNumber입니다. 승객에게 다른 값을 표시해야 하는 경우 이 필드를 사용하여 기본 동작을 재정의합니다.

예: 'XX1234 / YY576'

FlightCarrier

JSON 표현
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
입력란
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#flightCarrier".

carrierIataCode

string

운항 항공사가 아닌 판매 항공사의 두 자리 IATA 항공사 코드입니다. 이 중 정확히 하나 또는 carrierIcaoCodecarrieroperatingCarrier에 제공되어야 합니다.

예: Swiss Air의 경우 'LX'

carrierIcaoCode

string

운항 항공사가 아닌 판매 항공사의 세 자로 된 ICAO 항공사 코드입니다. 이 중 정확히 하나 또는 carrierIataCodecarrieroperatingCarrier에 제공되어야 합니다.

예: Easy Jet의 경우 'EZY'

airlineName

object (LocalizedString)

운송업체IataCode로 지정된 항공사의 현지화된 이름입니다. 설정하지 않으면 FlightClassissuerName 또는 localizedIssuerName이 표시에 사용됩니다.

예: 'LX'의 경우 'Swiss Air'

AirportInfo

JSON 표현
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
입력란
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#airportInfo".

airportIataCode

string

세 자로 된 IATA 공항 코드입니다. origindestination의 필수 필드입니다.

예: 'SFO'

terminal

string

터미널 이름. 예: 'INTL' 또는 'I'

gate

string

게이트의 이름입니다. 예: 'B59' 또는 '59'

airportNameOverride

object (LocalizedString)

IATA에서 정의한 공항 도시 이름을 재정의하는 선택적 필드입니다. 기본적으로 Google은 제공된 airportIataCode를 IATA에서 정의한 공식 공항 도시 이름에 매핑합니다.

공식 IATA 공항 도시 이름은 IATA 공항 도시 이름 웹사이트에서 확인할 수 있습니다. 예를 들어 공항 IATA 코드 'LTN'의 경우 IATA 웹사이트에 해당 공항 도시가 '런던'이라고 표시됩니다.

이 필드가 채워지지 않으면 '런던'이 표시됩니다.

하지만 이 입력란을 맞춤 이름 (예: 'London Luton')으로 채우면 재정의됩니다.

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

지정된 클래스 ID로 참조되는 항공편 클래스에 메시지를 추가합니다.

get

지정된 클래스 ID가 있는 항공편 클래스를 반환합니다.

insert

지정된 ID와 속성이 있는 항공편 클래스를 삽입합니다.

list

지정된 발급기관 ID의 모든 항공편 클래스 목록을 반환합니다.

patch

지정된 클래스 ID로 참조되는 항공편 클래스를 업데이트합니다.

update

지정된 클래스 ID로 참조되는 항공편 클래스를 업데이트합니다.