- 리소스: TransitObject
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
- PurchaseDetails
- TicketCost
- TicketLeg
- TicketSeat
- FareClass
- TripType
- ActivationStatus
- 상태
- DeviceContext
- 메서드
리소스: TransitObject
JSON 표현 |
---|
{ "classReference": { object ( |
필드 | |
---|---|
class |
상위 클래스의 상속 필드 사본입니다. 이러한 필드는 GET 실행 중 검색됩니다. |
ticket |
티켓 번호입니다. 대중교통 운영 시스템에서 티켓의 고유 식별자입니다. |
passenger |
승객 수입니다. |
passenger |
티켓이 할당된 승객의 이름입니다. 위의 |
trip |
사용자가 동일한 여행에 대해 여러 티켓을 저장한 경우 이 ID는 티켓을 그룹화하는 데 사용됩니다. |
ticket |
티켓의 상태입니다. 표시에 영향을 미치는 상태의 경우 |
custom |
|
concession |
티켓의 할인 카테고리입니다. |
custom |
|
ticket |
이 티켓 사용에 적용되는 제한사항의 종류에 대한 정보입니다. 예를 들어 사용해야 하는 요일 또는 취할 수 있는 노선 등입니다. |
purchase |
이 티켓의 구매 세부정보입니다. |
ticket |
단일 티켓 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 두 개 이상 지정하려면 |
ticket |
각 티켓에는 하나 이상의 구간이 포함될 수 있습니다. 각 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 하나만 지정하려면 |
hex |
카드의 배경 색상입니다. 설정되지 않은 경우 히어로 이미지의 주요 색상이 사용되고, 설정된 히어로 이미지가 없는 경우 로고의 주요 색상이 사용됩니다. 형식은 #rrggbb입니다. 여기서 rrggbb는 |
trip |
필수 항목입니다. 이 대중교통 객체가 나타내는 여행의 유형입니다. 패스 제목 또는 출발지와 목적지 사이에 사용할 기호를 결정하는 데 사용됩니다. |
id |
필수 항목입니다. 객체의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 객체에서 고유해야 합니다. 이 값은 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. 고유 식별자에는 영숫자 문자, '.', '_', '-'만 포함되어야 합니다. |
class |
필수 항목입니다. 이 객체에 연결된 클래스입니다. 클래스는 이 객체와 유형이 동일해야 하며, 이미 존재하고 승인된 상태여야 합니다. 클래스 ID는 issuer ID 형식을 따라야 합니다.identifier: Google에서 발급하며 후자는 개발자가 선택합니다. |
version |
지원 중단됨 |
state |
필수 항목입니다. 객체의 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어 |
barcode |
바코드 유형 및 값입니다. |
messages[] |
앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 이 배열의 관련 메시지를 수신합니다. 이러한 필드의 최대 개수는 10개입니다. |
valid |
이 객체가 |
locations[] |
참고: 이 필드는 현재 지역 알림을 트리거하는 데 지원되지 않습니다. |
has |
객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다. |
smart |
이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스가 스마트 탭을 지원하려면 클래스 수준 필드 |
has |
이 객체가 현재 단일 기기에 연결되어 있는지 여부입니다. 사용자가 객체를 저장하여 기기에 연결하면 플랫폼에서 이 필드를 설정합니다. 일부 파트너만 사용할 수 있습니다. 자세한 내용은 지원팀에 문의하세요. |
disable |
알림을 명시적으로 억제해야 하는지 여부를 나타냅니다. 이 필드를 true로 설정하면 현재 이 속성은 혜택에만 설정할 수 있습니다. |
info |
지원 중단되었습니다. 대신 textModulesData를 사용하세요. |
image |
이미지 모듈 데이터입니다. 이러한 표시된 필드의 최대 개수는 객체 수준에서 1개이고 클래스 객체 수준에서 1개입니다. |
text |
텍스트 모듈 데이터 텍스트 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. 이러한 필드의 최대 개수는 객체에서 10개, 클래스에서 10개입니다. |
links |
링크 모듈 데이터입니다. 링크 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. |
app |
패스 앞면에 버튼으로 표시되는 앱 또는 웹사이트 링크(선택사항)입니다. 해당하는 클래스에 AppLinkData가 제공되면 객체 AppLinkData만 표시됩니다. |
activation |
객체의 활성화 상태입니다. 클래스에 |
rotating |
회전 바코드 유형 및 값입니다. |
device |
객체와 연결된 기기 컨텍스트입니다. |
hero |
카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 없으면 클래스의 히어로 이미지(있는 경우)가 표시됩니다. 클래스의 히어로 이미지도 없는 경우 아무것도 표시되지 않습니다. |
grouping |
패스가 그룹화되는 방식을 제어하는 정보입니다. |
pass |
객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한을 포함합니다. |
save |
사용자가 패스를 저장하려고 시도하기 전에 확인해야 하는 객체에 대한 제한사항입니다. 이 제한사항은 절약 모드 중에만 적용됩니다. 사용자가 패스를 저장한 후에 제한사항이 변경되면 이미 저장된 패스에는 새 제한사항이 적용되지 않습니다. |
linked |
linkedObjectIds는 이 대중교통 객체에 자동으로 연결되어야 하는 이벤트 티켓, 포인트 제도, 혜택, 일반, 기프트 카드, 대중교통, 탑승권과 같은 다른 객체의 목록입니다. 사용자가 이 교통카드를 저장한 경우 이러한linkedObjectId가 자동으로 사용자의 월렛으로 푸시됩니다 (사용자가 연결된 패스를 수신하도록 설정을 사용 중지하지 않은 경우). linkedObjectIds에 있는 객체가 이미 삽입되었는지 확인합니다. 그렇지 않으면 호출이 실패합니다. 연결된 후에는 연결된 객체를 연결 해제할 수 없습니다. 다른 발급기관에 속한 객체는 연결할 수 없습니다. 단일 객체에 연결할 수 있는 객체의 수에는 제한이 있습니다. 한도에 도달하면 호출의 새 연결된 객체가 자동으로 무시됩니다. 객체 ID는 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. |
notify |
이 객체의 필드 업데이트 시 알림을 트리거할지 여부입니다. NOTIFY로 설정하면 사용자에게 필드 업데이트 알림을 트리거하려고 시도합니다. 이러한 알림은 필드가 허용 목록에 포함된 경우에만 사용자에게 전송됩니다. DO_NOT_NOTIFY 또는 NOTIFICATION_SETTINGS_UNSPECIFIED로 설정하면 알림이 트리거되지 않습니다. 이 설정은 일시적이며 각 PATCH 또는 UPDATE 요청과 함께 설정해야 합니다. 그러지 않으면 알림이 트리거되지 않습니다. |
value |
선택사항인 부가가치 모듈 데이터입니다. 객체 최대 10개. |
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 ( |
필드 | |
---|---|
route |
이용 가능한 경로에 대한 제한사항입니다. 예를 들어 '예약된 CrossCountry 열차 전용'일 수 있습니다. |
route |
위의 |
time |
이 티켓을 사용할 수 있는 시간에 대한 제한입니다. |
other |
'노선' 또는 '시간' 카테고리에 포함되지 않는 추가 제한사항입니다. |
PurchaseDetails
JSON 표현 |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
필드 | |
---|---|
purchase |
티켓을 판매한 기관을 통한 티켓 구매 추적에 사용할 영수증 번호/식별자입니다. |
purchase |
티켓 구매 날짜/시간입니다. 오프셋 적용 여부와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 최대 나노초 단위로 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다. 예를 들면 다음과 같습니다.
오프셋 정보가 없으면 풍부한 기능의 일부를 사용하지 못할 수 있습니다. |
account |
티켓 구매에 사용된 계정의 ID입니다. |
confirmation |
구매의 확인 코드입니다. 여러 티켓의 경우 동일할 수 있으며 티켓을 그룹화하는 데 사용됩니다. |
ticket |
티켓 비용입니다. |
TicketCost
JSON 표현 |
---|
{ "faceValue": { object ( |
필드 | |
---|---|
face |
티켓의 액면가입니다. |
purchase |
세금 또는 할인 후 티켓의 실제 구매 가격입니다. |
discount |
적용된 모든 종류의 할인을 설명하는 메시지입니다. |
TicketLeg
JSON 표현 |
---|
{ "originStationCode": string, "originName": { object ( |
필드 | |
---|---|
origin |
출발지 정거장 코드입니다. |
origin |
출발지 정거장의 이름입니다. |
destination |
목적지 정거장 코드입니다. |
destination |
대상 이름입니다. |
departure |
출발 날짜/시간입니다. 대중교통 객체에 유효 시간 간격이 설정되지 않은 경우 필수입니다. 오프셋 유무와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 오프셋은 초 정밀도로 지정할 수 있습니다 (오프셋 초는 ISO 8601의 일부가 아님). 예를 들면 다음과 같습니다.
날짜/시간에서 오프셋이 없는 부분은 '현지 날짜/시간'으로 간주됩니다. 출발지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 출발이 출발지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은 오프셋 정보가 없으면 풍부한 기능의 일부를 사용하지 못할 수 있습니다. |
arrival |
도착 날짜/시간입니다. 오프셋 유무와 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 최대 나노초 단위로 지정할 수 있습니다. 오프셋은 초 정밀도로 지정할 수 있습니다 (오프셋 초는 ISO 8601의 일부가 아님). 예를 들면 다음과 같습니다.
오프셋이 없는 날짜/시간 부분은 '현지 날짜/시간'으로 간주됩니다. 목적지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 이벤트가 목적지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은 오프셋 정보가 없으면 일부 고급 기능을 사용하지 못할 수 있습니다. |
fare |
이 여행 구간의 요금에 대한 간단한 설명/이름입니다. (예: '상시 일회용') |
carriage |
승객이 탑승해야 하는 열차 또는 선박 이름/번호입니다. |
platform |
승객이 탑승할 수 있는 플랫폼 또는 게이트입니다. |
zone |
플랫폼 내 탑승 구역입니다. |
ticket |
승객의 지정 좌석입니다. 좌석을 두 개 이상 지정하려면 |
ticket |
승객 예약석입니다. 좌석을 하나만 지정하려면 |
transit |
이 여행 구간을 운영하는 대중교통 운영자의 이름입니다. |
transit |
열차/버스 등의 종점 정거장 또는 목적지입니다. |
TicketSeat
JSON 표현 |
---|
{ "fareClass": enum ( |
필드 | |
---|---|
fare |
발권된 좌석의 요금 등급입니다. |
custom |
|
coach |
발권된 좌석이 위치한 열차 또는 객차의 식별자입니다. (예: '10' |
seat |
발권된 좌석이 위치한 곳의 식별자입니다. (예: '42'. 특정 식별자가 없는 경우 대신 |
seat |
승객의 좌석 배정입니다. (예: '특정 좌석 없음'. |
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 } |
필드 | |
---|---|
device |
설정하면, 객체 활성화 시에만 사용 정보가 지정된 기기로 반환됩니다. 이 ID는 사용자의 기기를 추적하는 데 안정적인 식별자로 사용해서는 안 됩니다. 동일한 기기의 여러 패스 또는 동일한 기기의 여러 활성화 간에 변경될 수 있습니다. 이를 설정할 때 호출자는 활성화되는 객체에 hasLinkedDevice도 설정해야 합니다. |
메서드 |
|
---|---|
|
지정된 객체 ID로 참조되는 대중교통 객체에 메시지를 추가합니다. |
|
지정된 객체 ID가 있는 대중교통 객체를 반환합니다. |
|
지정된 ID와 속성이 있는 대중교통 객체를 삽입합니다. |
|
지정된 발급기관 ID의 모든 대중교통 객체 목록을 반환합니다. |
|
지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다. |
|
지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다. |