REST Resource: flightobject

리소스: FlightObject

JSON 표현
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
필드
kind
(deprecated)

string

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

classReference

object (FlightClass)

상위 클래스의 상속 필드 사본입니다. 이러한 필드는 GET 실행 중에 검색됩니다.

passengerName

string

필수 항목입니다. 탑승권에 표시되는 승객 이름입니다.

예: 'Dave M Gahan', 'Gahan/Dave', 'GAHAN/DAVEM'

boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

승객별 탑승 및 좌석 정보입니다.

reservationInfo

object (ReservationInfo)

필수 항목입니다. 항공편 예약 정보입니다.

hexBackgroundColor

string

카드의 배경 색상입니다. 설정되지 않은 경우 히어로 이미지의 주요 색상이 사용되고, 설정된 히어로 이미지가 없는 경우 로고의 주요 색상이 사용됩니다. 형식은 #rrggbb입니다. 여기서 rrggbb#ffcc00과 같은 16진수 RGB 3색입니다. #rgb과 같은 RGB 3색의 축약 버전(예: #fc0)을 사용해도 됩니다.

id

string

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

classId

string

필수 항목입니다. 이 객체에 연결된 클래스입니다. 클래스는 이 객체와 유형이 동일해야 하며, 이미 존재하고 승인된 상태여야 합니다.

클래스 ID는 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다.

version
(deprecated)

string (int64 format)

지원 중단됨

state

enum (State)

필수 항목입니다. 객체 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어 inactive 객체는 '만료된 패스' 섹션으로 이동됩니다.

barcode

object (Barcode)

바코드 유형 및 값입니다.

messages[]

object (Message)

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

validTimeInterval

object (TimeInterval)

이 객체가 active 상태가 되어 객체를 사용할 수 있는 기간입니다. 이 기간이 지나면 객체의 상태가 expired로 변경됩니다.

locations[]
(deprecated)

object (LatLongPoint)

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

hasUsers

boolean

객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다.

smartTapRedemptionValue

string

이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스가 스마트 탭을 지원하려면 클래스 수준 필드 enableSmartTapredemptionIssuers도 올바르게 설정되어야 합니다. ASCII 문자만 지원됩니다.

hasLinkedDevice

boolean

이 객체가 현재 하나의 기기에 연결되어 있는지 여부입니다. 사용자가 객체를 저장하여 기기에 연결하면 플랫폼에서 이 필드를 설정합니다. 일부 파트너만 사용할 수 있습니다. 자세한 내용은 지원팀에 문의하세요.

disableExpirationNotification

boolean

알림을 명시적으로 억제해야 하는지 여부를 나타냅니다. 이 필드를 true로 설정하면 messages 필드에 관계없이 사용자에게 만료 알림이 표시되지 않습니다. 이 필드의 기본 설정값은 false입니다.

현재 이 속성은 항공편에만 설정할 수 있습니다.

infoModuleData

object (InfoModuleData)

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

imageModulesData[]

object (ImageModuleData)

이미지 모듈 데이터입니다. 이러한 표시된 필드의 최대 개수는 객체 수준에서 1개이고 클래스 객체 수준에서 1개입니다.

textModulesData[]

object (TextModuleData)

텍스트 모듈 데이터입니다. 텍스트 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. 이러한 필드의 최대 개수는 객체에서 10개, 클래스에서 10개입니다.

rotatingBarcode

object (RotatingBarcode)

회전 바코드 유형 및 값입니다.

heroImage

object (Image)

카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 없으면 클래스의 히어로 이미지(있는 경우)가 표시됩니다. 클래스의 히어로 이미지도 없는 경우 아무것도 표시되지 않습니다.

groupingInfo

object (GroupingInfo)

패스를 그룹화하는 방식을 제어하는 정보입니다.

passConstraints

object (PassConstraints)

객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한을 포함합니다.

saveRestrictions

object (SaveRestrictions)

사용자가 패스를 저장하려고 시도하기 전에 확인해야 하는 객체에 대한 제한사항입니다. 이 제한은 절약 시간 중에만 적용됩니다. 사용자가 패스를 저장한 후 제한사항이 변경되면 이미 저장된 패스에는 새 제한사항이 적용되지 않습니다.

linkedObjectIds[]

string

linkedObjectIds는 이 항공편 객체에 자동으로 연결되어야 하는 이벤트 티켓, 포인트, 쿠폰, 일반, 기프트 카드, 대중교통, 탑승권과 같은 다른 객체의 목록입니다. 사용자가 이 탑승권을 저장한 경우 이러한 연결된 탑승권을 수신하도록 설정을 사용 중지하지 않는 한 이러한 linkedObjectIds가 사용자의 지갑에 자동으로 푸시됩니다.

linkedObjectIds에 있는 객체가 이미 삽입되었는지 확인합니다. 그렇지 않으면 호출이 실패합니다. 연결된 객체는 연결을 해제할 수 없습니다. 다른 발급기관에 속한 객체는 연결할 수 없습니다. 단일 객체에 연결할 수 있는 객체 수에는 제한이 있습니다. 한도에 도달하면 호출의 새 연결된 객체가 자동으로 무시됩니다.

객체 ID는 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다.

notifyPreference

enum (NotificationSettingsForUpdates)

이 객체의 필드 업데이트가 알림을 트리거해야 하는지 여부입니다. NOTIFY로 설정하면 사용자에게 필드 업데이트 알림을 트리거하려고 시도합니다. 이러한 알림은 필드가 허용 목록에 포함된 경우에만 사용자에게 전송됩니다. DO_NOT_NOTIFY 또는 NOTIFICATION_SETTINGS_UNSPECIFIED로 설정하면 알림이 트리거되지 않습니다. 이 설정은 일시적이며 각 PATCH 또는 UPDATE 요청과 함께 설정해야 합니다. 그러지 않으면 알림이 트리거되지 않습니다.

valueAddedModuleData[]

object (ValueAddedModuleData)

부가가치 모듈 데이터(선택사항) 객체 최대 10개.

BoardingAndSeatingInfo

JSON 표현
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
필드
kind
(deprecated)

string

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

boardingGroup

string

승객이 탑승해야 하는 탑승 그룹 (영역)의 값입니다.

예: 'B'

이 값의 라벨은 이 객체가 참조하는 flightClassboardingPolicy 필드에 따라 결정됩니다.

seatNumber

string

승객 좌석의 값입니다. 특정 식별자가 없는 경우 seatAssignment를 대신 사용하세요.

예: '25A'

seatClass

string

좌석 등급의 값입니다.

예: '이코노미' 또는 '이코노미 플러스'

boardingPrivilegeImage

object (Image)

탑승 바코드 위에 표시되는 작은 이미지입니다. 항공사는 이를 통해 특별 탑승 권한을 전달할 수 있습니다. 보안 프로그램 로고도 설정되어 있는 경우 이 이미지가 보안 프로그램의 로고와 함께 렌더링될 수 있습니다.

boardingPosition

string

탑승 위치의 값입니다.

예: '76'

sequenceNumber

string

탑승권의 순서 번호입니다. 일반적으로 승객이 체크인한 순서와 일치합니다. 항공사는 수동 탑승과 수하물 태그에 이 번호를 사용할 수 있습니다.

예: '49'

boardingDoor

enum (BoardingDoor)

항공편에 이용되는 탑승구 또는 탑승교가 둘 이상이고 탑승권에 탑승구 위치를 명시하려는 경우에만 이 필드를 설정합니다. 대부분의 항공사는 탑승구/탑승교를 seatClass로 표시하여 승객을 올바른 탑승구나 탑승교로 안내합니다. 이 경우 boardingDoor를 설정하면 안 됩니다.

seatAssignment

object (LocalizedString)

승객의 좌석 배정입니다. seatNumber에 사용할 특정 식별자가 없는 경우 사용됩니다.

예: 'assigned at gate'

BoardingDoor

열거형
BOARDING_DOOR_UNSPECIFIED
FRONT
front

FRONT의 기존 별칭입니다. 지원 중단되었습니다.

BACK
back

BACK의 기존 별칭입니다. 지원 중단되었습니다.

ReservationInfo

JSON 표현
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
필드
kind
(deprecated)

string

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

confirmationCode

string

이 항공편을 체크인하는 데 필요한 확인 코드입니다.

승객이 공항의 키오스크에서 이 번호를 입력하여 항공편을 검색하고 탑승권을 인쇄합니다.

eticketNumber

string

전자 항공권 번호입니다.

frequentFlyerInfo

object (FrequentFlyerInfo)

항공사 멤버십 정보입니다.

FrequentFlyerInfo

JSON 표현
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
필드
kind
(deprecated)

string

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

frequentFlyerProgramName

object (LocalizedString)

항공사 멤버십 프로그램 이름입니다(예: 'Lufthansa Miles & More').

frequentFlyerNumber

string

항공사 멤버십 번호입니다.

walletobjects#frequentFlyerInfo 종류의 각 중첩 객체에 필요합니다.

메서드

addmessage

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

get

지정된 객체 ID가 있는 항공편 객체를 반환합니다.

insert

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

list

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

patch

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

update

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