- 리소스: TransitObject
 - PassengerType
 - TicketStatus
 - ConcessionCategory
 - TicketRestrictions
 - PurchaseDetails
 - TicketCost
 - TicketLeg
 - TicketSeat
 - FareClass
 - TripType
 - ActivationStatus
 - 상태
 - DeviceContext
 - 메서드
 
리소스: TransitObject
| JSON 표현 | 
|---|
{ "classReference": { object (  | 
              
| 필드 | |
|---|---|
classReference | 
                
                   
 상위 클래스의 상속 필드 사본입니다. 이러한 필드는 GET 실행 중 검색됩니다.  | 
              
ticketNumber | 
                
                   
 티켓 번호입니다. 대중교통 운영 시스템에서 티켓의 고유 식별자입니다.  | 
              
passengerType | 
                
                   
 승객 수입니다.  | 
              
passengerNames | 
                
                   
 티켓이 할당된 승객의 이름입니다. 위의   | 
              
tripId | 
                
                   
 사용자가 동일한 여행에 대해 여러 티켓을 저장한 경우 이 ID는 티켓을 그룹화하는 데 사용됩니다.  | 
              
ticketStatus | 
                
                   
 티켓의 상태입니다. 표시에 영향을 미치는 상태의 경우   | 
              
customTicketStatus | 
                
                   
 
  | 
              
concessionCategory | 
                
                   
 티켓의 할인 카테고리입니다.  | 
              
customConcessionCategory | 
                
                   
 
  | 
              
ticketRestrictions | 
                
                   
 이 티켓 사용에 적용되는 제한의 종류에 대한 정보입니다. 예를 들어 사용해야 하는 요일 또는 취할 수 있는 노선 등입니다.  | 
              
purchaseDetails | 
                
                   
 이 티켓의 구매 세부정보입니다.  | 
              
ticketLeg | 
                
                   
 단일 티켓 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 두 개 이상 지정하려면   | 
              
ticketLegs[] | 
                
                   
 각 티켓에는 하나 이상의 구간이 포함될 수 있습니다. 각 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 하나만 지정하려면   | 
              
hexBackgroundColor | 
                
                   
 카드의 배경 색상입니다. 설정되지 않은 경우 히어로 이미지의 주요 색상이 사용되고, 설정된 히어로 이미지가 없는 경우 로고의 주요 색상이 사용됩니다. 형식은 #rrggbb입니다. 여기서 rrggbb는   | 
              
tripType | 
                
                   
 필수입니다. 이 대중교통 객체가 나타내는 여행의 유형입니다. 패스 제목 또는 출발지와 목적지 사이에 사용할 기호를 결정하는 데 사용됩니다.  | 
              
id | 
                
                   
 필수입니다. 객체의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 객체에서 고유해야 합니다. 이 값은 issuer ID 형식이어야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. 고유 식별자에는 영숫자 문자, '.', '_', '-'만 포함되어야 합니다.  | 
              
classId | 
                
                   
 필수입니다. 이 객체에 연결된 클래스입니다. 클래스는 이 객체와 유형이 동일해야 하며, 이미 존재하고 승인된 상태여야 합니다. 클래스 ID는 issuer ID 형식이어야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다.  | 
              
version | 
                
                   
 지원 중단됨  | 
              
state | 
                
                   
 필수입니다. 객체 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어   | 
              
barcode | 
                
                   
 바코드 유형 및 값입니다.  | 
              
messages[] | 
                
                   
 앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 이 배열의 관련 메시지를 수신합니다. 이 필드의 최대 개수는 10개입니다.  | 
              
validTimeInterval | 
                
                   
 이 객체가   | 
              
locations[] | 
                
                   
 참고: 이 필드는 현재 위치 알림을 트리거하는 데 지원되지 않습니다.  | 
              
hasUsers | 
                
                   
 객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다.  | 
              
smartTapRedemptionValue | 
                
                   
 이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스가 스마트 탭을 지원하려면 클래스 수준 필드   | 
              
hasLinkedDevice | 
                
                   
 이 객체가 현재 하나의 기기에 연결되어 있는지 여부입니다. 사용자가 객체를 저장하여 기기에 연결하면 플랫폼에서 이 필드를 설정합니다. 일부 파트너만 사용할 수 있습니다. 자세한 내용은 지원팀에 문의하세요.  | 
              
disableExpirationNotification | 
                
                   
 알림을 명시적으로 해제해야 하는지 여부를 나타냅니다. 이 필드를 true로 설정하면  현재 이 속성은 혜택에만 설정할 수 있습니다.  | 
              
infoModuleData | 
                
                   
 지원 중단되었습니다. 대신 textModulesData를 사용하세요.  | 
              
imageModulesData[] | 
                
                   
 이미지 모듈 데이터입니다. 이러한 표시된 필드의 최대 개수는 객체 수준에서 1개이고 클래스 객체 수준에서 1개입니다.  | 
              
textModulesData[] | 
                
                   
 텍스트 모듈 데이터입니다. 텍스트 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. 이러한 표시된 필드의 최대 개수는 객체에서 10개이고 클래스에서 10개입니다.  | 
              
linksModuleData | 
                
                   
 링크 모듈 데이터입니다. 링크 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다.  | 
              
appLinkData | 
                
                   
 패스 앞면에 버튼으로 표시되는 앱 또는 웹사이트 링크(선택사항)입니다. 상응하는 클래스에 AppLinkData가 제공되면 AppLinkData 객체만 표시됩니다.  | 
              
activationStatus | 
                
                   
 객체의 활성화 상태입니다. 클래스에   | 
              
rotatingBarcode | 
                
                   
 회전 바코드 유형 및 값입니다.  | 
              
deviceContext | 
                
                   
 객체와 연결된 기기 컨텍스트입니다.  | 
              
heroImage | 
                
                   
 카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 없으면 클래스의 히어로 이미지(있는 경우)가 표시됩니다. 클래스의 히어로 이미지도 없으면 아무것도 표시되지 않습니다.  | 
              
groupingInfo | 
                
                   
 패스가 그룹화되는 방식을 제어하는 정보입니다.  | 
              
passConstraints | 
                
                   
 객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한을 포함합니다.  | 
              
saveRestrictions | 
                
                   
 사용자가 패스를 저장하려고 시도하기 전에 확인해야 하는 객체에 대한 제한사항입니다. 이 제한사항은 절약 시간 동안만 적용됩니다. 사용자가 패스를 저장한 후에 제한사항이 변경되면 이미 저장된 패스에는 새 제한사항이 적용되지 않습니다.  | 
              
linkedObjectIds[] | 
                
                   
 linkedObjectIds는 이 대중교통 객체에 자동으로 연결되어야 하는 이벤트 티켓, 포인트 제도, 혜택, 일반, 기프트 카드, 대중교통, 탑승권과 같은 다른 객체의 목록입니다. 사용자가 이 대중교통 카드를 저장한 경우 이러한 연결된 패스를 수신하는 설정을 사용 중지하지 않는 한 이러한 linkedObjectIds가 사용자의 지갑에 자동으로 푸시됩니다. linkedObjectIds에 있는 객체가 이미 삽입되었는지 확인합니다. 그렇지 않으면 호출이 실패합니다. 연결된 객체는 연결을 해제할 수 없습니다. 다른 발급기관에 속한 객체는 연결할 수 없습니다. 단일 객체에 연결할 수 있는 객체 수에는 제한이 있습니다. 한도에 도달하면 호출의 새 연결된 객체가 자동으로 무시됩니다. 객체 ID는 issuer ID 형식이어야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다.  | 
              
notifyPreference | 
                
                   
 이 객체의 필드 업데이트가 알림을 트리거해야 하는지 여부입니다. NOTIFY로 설정하면 사용자에게 필드 업데이트 알림을 트리거하려고 시도합니다. 이러한 알림은 필드가 허용 목록에 포함된 경우에만 사용자에게 전송됩니다. DO_NOT_NOTIFY 또는 NOTIFICATION_SETTINGS_UNSPECIFIED로 설정하면 알림이 트리거되지 않습니다. 이 설정은 일시적이며 각 PATCH 또는 UPDATE 요청과 함께 설정해야 합니다. 그러지 않으면 알림이 트리거되지 않습니다.  | 
              
valueAddedModuleData[] | 
                
                   
 부가가치 모듈 데이터(선택사항) 객체에 최대 10개까지 포함할 수 있습니다.  | 
              
merchantLocations[] | 
                
                   
 판매자 위치 객체에 최대 10개가 있을 수 있습니다. 10개를 초과하여 MerchantLocation을 추가하면 거부됩니다. 이러한 위치는 사용자가 Google에서 설정한 지점 반경 내에 들어가면 알림을 트리거합니다. 이 필드는 지원 중단된 LatLongPoints를 대체합니다.  | 
              
PassengerType
| 열거형 | |
|---|---|
PASSENGER_TYPE_UNSPECIFIED | 
                |
SINGLE_PASSENGER | 
                |
singlePassenger | 
                
  | 
              
MULTIPLE_PASSENGERS | 
                |
multiplePassengers | 
                
  | 
              
TicketStatus
| 열거형 | |
|---|---|
TICKET_STATUS_UNSPECIFIED | 
                |
USED | 
                |
used | 
                
  | 
              
REFUNDED | 
                |
refunded | 
                
  | 
              
EXCHANGED | 
                |
exchanged | 
                
  | 
              
ConcessionCategory
| 열거형 | |
|---|---|
CONCESSION_CATEGORY_UNSPECIFIED | 
                |
ADULT | 
                |
adult | 
                
  | 
              
CHILD | 
                |
child | 
                
  | 
              
SENIOR | 
                |
senior | 
                
  | 
              
TicketRestrictions
| JSON 표현 | 
|---|
{ "routeRestrictions": { object (  | 
              
| 필드 | |
|---|---|
routeRestrictions | 
                
                   
 이용 가능한 노선에 대한 제한입니다. 예를 들어 '예약된 CrossCountry 열차 전용'일 수 있습니다.  | 
              
routeRestrictionsDetails | 
                
                   
 위의   | 
              
timeRestrictions | 
                
                   
 이 티켓을 사용할 수 있는 시간에 대한 제한입니다.  | 
              
otherRestrictions | 
                
                   
 '노선' 또는 '시간' 카테고리에 포함되지 않는 추가 제한사항입니다.  | 
              
PurchaseDetails
| JSON 표현 | 
|---|
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object ( | 
              
| 필드 | |
|---|---|
purchaseReceiptNumber | 
                
                   
 티켓을 판매한 기관을 통한 티켓 구매 추적에 사용할 영수증 번호/식별자입니다.  | 
              
purchaseDateTime | 
                
                   
 티켓 구매 날짜/시간입니다. 오프셋 적용 여부와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다. 예를 들면 다음과 같습니다. 
 
 
 오프셋 정보가 없으면 일부 고급 기능을 사용하지 못할 수 있습니다.  | 
              
accountId | 
                
                   
 티켓 구매에 사용된 계정의 ID입니다.  | 
              
confirmationCode | 
                
                   
 구매 확인 코드입니다. 여러 티켓의 코드가 동일할 수 있으며 티켓을 그룹화하는 데 사용됩니다.  | 
              
ticketCost | 
                
                   
 티켓 비용입니다.  | 
              
TicketCost
| JSON 표현 | 
|---|
{ "faceValue": { object (  | 
              
| 필드 | |
|---|---|
faceValue | 
                
                   
 티켓의 액면가입니다.  | 
              
purchasePrice | 
                
                   
 세금 또는 할인 후 티켓의 실제 구매 가격입니다.  | 
              
discountMessage | 
                
                   
 적용된 모든 종류의 할인을 설명하는 메시지입니다.  | 
              
TicketLeg
| JSON 표현 | 
|---|
{ "originStationCode": string, "originName": { object (  | 
              
| 필드 | |
|---|---|
originStationCode | 
                
                   
 출발지 정거장 코드입니다.   | 
              
originName | 
                
                   
 출발지 정거장의 이름입니다.   | 
              
destinationStationCode | 
                
                   
 목적지 정거장 코드입니다.  | 
              
destinationName | 
                
                   
 대상 이름입니다.  | 
              
departureDateTime | 
                
                   
 출발 날짜/시간입니다. 대중교통 객체에 유효 시간 간격이 설정되지 않은 경우 필수입니다. 오프셋 적용 여부와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다. 예를 들면 다음과 같습니다. 
 
 
 오프셋이 없는 날짜/시간 부분은 '현지 날짜/시간'으로 간주됩니다. 출발지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 출발이 출발지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은  오프셋 정보가 없으면 일부 고급 기능을 사용하지 못할 수 있습니다.  | 
              
arrivalDateTime | 
                
                   
 도착 날짜/시간입니다. 오프셋 적용 여부와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다. 예를 들면 다음과 같습니다. 
 
 
 오프셋이 없는 날짜/시간 부분은 '현지 날짜/시간'으로 간주됩니다. 목적지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 이벤트가 목적지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은  오프셋 정보가 없으면 일부 고급 기능을 사용하지 못할 수 있습니다.  | 
              
fareName | 
                
                   
 이 여행 구간의 요금에 대한 간단한 설명/이름입니다. 예: '언제든 일회 사용'  | 
              
carriage | 
                
                   
 승객이 탑승해야 하는 열차 또는 선박 이름/번호입니다.  | 
              
platform | 
                
                   
 승객이 탑승할 수 있는 플랫폼 또는 게이트입니다.  | 
              
zone | 
                
                   
 플랫폼 내 탑승 구역입니다.  | 
              
ticketSeat | 
                
                   
 승객 예약석입니다. 좌석을 두 개 이상 지정하려면   | 
              
ticketSeats[] | 
                
                   
 승객 예약석입니다. 좌석을 하나만 지정하려면   | 
              
transitOperatorName | 
                
                   
 이 여행 구간을 운영하는 대중교통 운영자의 이름입니다.  | 
              
transitTerminusName | 
                
                   
 열차/버스 등의 종점 정거장 또는 목적지입니다.  | 
              
TicketSeat
| JSON 표현 | 
|---|
{ "fareClass": enum (  | 
              
| 필드 | |
|---|---|
fareClass | 
                
                   
 발권된 좌석의 요금 등급입니다.  | 
              
customFareClass | 
                
                   
 
  | 
              
coach | 
                
                   
 발권된 좌석이 위치한 열차 또는 객차의 식별자입니다. (예: '10'  | 
              
seat | 
                
                   
 발권된 좌석이 위치한 곳의 식별자입니다. (예: '42'. 특정 식별자가 없는 경우   | 
              
seatAssignment | 
                
                   
 승객의 좌석 배정입니다. (예: '특정 좌석 없음'.   | 
              
FareClass
| 열거형 | |
|---|---|
FARE_CLASS_UNSPECIFIED | 
                |
ECONOMY | 
                |
economy | 
                
  | 
              
FIRST | 
                |
first | 
                
  | 
              
BUSINESS | 
                |
business | 
                
  | 
              
TripType
| 열거형 | |
|---|---|
TRIP_TYPE_UNSPECIFIED | 
                |
ROUND_TRIP | 
                |
roundTrip | 
                
  | 
              
ONE_WAY | 
                |
oneWay | 
                
  | 
              
ActivationStatus
객체의 활성화 상태입니다. 값이 활성화를 지원하는 경우 이 필드에는 활성화 상태가 포함됩니다.
| JSON 표현 | 
|---|
{
  "state": enum ( | 
              
| 필드 | |
|---|---|
state | 
                
                   
  | 
              
주
| 열거형 | |
|---|---|
UNKNOWN_STATE | 
                |
NOT_ACTIVATED | 
                활성화되지 않음(기본 상태) | 
not_activated | 
                
  | 
              
ACTIVATED | 
                활성화됨 | 
activated | 
                
  | 
              
DeviceContext
객체와 연결된 기기 컨텍스트입니다.
| JSON 표현 | 
|---|
{ "deviceToken": string }  | 
              
| 필드 | |
|---|---|
deviceToken | 
                
                   
 이 옵션을 설정하면 객체가 활성화될 때만 기기에 사용 정보가 반환됩니다. 이 ID는 사용자의 기기를 추적하는 안정적인 식별자로 사용해서는 안 됩니다. 동일한 기기의 여러 패스 간에 또는 동일한 기기의 여러 활성화 간에 변경될 수 있습니다. 이를 설정할 때 호출자는 활성화되는 객체에 hasLinkedDevice도 설정해야 합니다.  | 
              
메서드 | 
            |
|---|---|
                
 | 
              지정된 객체 ID로 참조되는 대중교통 객체에 메시지를 추가합니다. | 
                
 | 
              지정된 객체 ID가 있는 대중교통 객체를 반환합니다. | 
                
 | 
              지정된 ID와 속성이 있는 대중교통 객체를 삽입합니다. | 
                
 | 
              지정된 발급기관 ID의 모든 대중교통 객체 목록을 반환합니다. | 
                
 | 
              지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다. | 
                
 | 
              지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다. |