패키지 google.walletobjects.v1.transit

색인

TransitClassService

AddMessage

rpc AddMessage(TransitClassAddMessageRequest) returns (TransitClassAddMessageResponse)

지정된 클래스 ID로 참조되는 대중교통 클래스에 메시지를 추가합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(TransitClassGetRequest) returns (TransitClass)

지정된 클래스 ID가 있는 대중교통 클래스를 반환합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(TransitClassInsertRequest) returns (TransitClass)

지정된 ID와 속성이 있는 대중교통 클래스를 삽입합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(TransitClassListRequest) returns (TransitClassListResponse)

지정된 발급기관 ID의 모든 대중교통 클래스 목록을 반환합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(TransitClassPatchRequest) returns (TransitClass)

지정된 클래스 ID로 참조되는 대중교통 클래스를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(TransitClassUpdateRequest) returns (TransitClass)

지정된 클래스 ID로 참조되는 대중교통 클래스를 업데이트합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer

TransitObjectService

AddMessage

rpc AddMessage(TransitObjectAddMessageRequest) returns (TransitObjectAddMessageResponse)

지정된 객체 ID로 참조되는 대중교통 객체에 메시지를 추가합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(TransitObjectGetRequest) returns (TransitObject)

지정된 객체 ID가 있는 대중교통 객체를 반환합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(TransitObjectInsertRequest) returns (TransitObject)

지정된 ID와 속성이 있는 대중교통 객체를 삽입합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(TransitObjectListRequest) returns (TransitObjectListResponse)

지정된 발급기관 ID의 모든 대중교통 객체 목록을 반환합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(TransitObjectPatchRequest) returns (TransitObject)

지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(TransitObjectUpdateRequest) returns (TransitObject)

지정된 객체 ID로 참조되는 대중교통 객체를 업데이트합니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/wallet_object.issuer

PurchaseDetails

필드
purchase_receipt_number

string

티켓을 판매한 기관을 통한 티켓 구매 추적에 사용할 영수증 번호/식별자입니다.

purchase_date_time

string

티켓 구매 날짜/시간입니다.

오프셋 적용에 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다.

예를 들면 다음과 같습니다.

1985-04-12T23:20:50.52Z는 1985년 4월 12일 23시 20분 50.52초(UTC 기준)입니다.

1985-04-12T19:20:50.52-04:00은 UTC보다 4시간 늦은 1985년 4월 12일 19시 20분 50.52초입니다(위의 예시와 같은 시점). 이벤트가 뉴욕에서 진행된다면 이 시간은 미 동부 하계 표준시(EDT)에 해당합니다. 일광 절약 시간(서머타임)을 시행하는 지역에서는 연중 시점에 따라 오프셋이 다르게 적용된다는 점에 유의하세요.

1985-04-12T19:20:50.52는 오프셋 정보가 없는 1985년 4월 12일 19시 20분 50.52초입니다.

오프셋 정보가 없으면 고급 기능 중 일부를 사용하지 못할 수 있습니다.

account_id

string

티켓 구매에 사용된 계정의 ID입니다.

confirmation_code

string

구매 확인 코드입니다. 여러 티켓의 코드가 동일할 수 있으며 티켓을 그룹화하는 데 사용됩니다.

ticket_cost

TicketCost

티켓 비용입니다.

TicketCost

필드
face_value

Money

티켓의 액면가입니다.

purchase_price

Money

세금 또는 할인 후 티켓의 실제 구매 가격입니다.

discount_message

LocalizedString

적용된 모든 종류의 할인을 설명하는 메시지입니다.

TicketLeg

필드
origin_station_code

string

출발지 정거장 코드입니다. destinationStationCode가 있거나 originName이 없는 경우 필수입니다.

origin_name

LocalizedString

출발지 정거장의 이름입니다. desinationName이 있거나 originStationCode가 없는 경우 필수입니다.

destination_station_code

string

목적지 정거장 코드입니다.

destination_name

LocalizedString

목적지 이름입니다.

departure_date_time

string

출발 날짜/시간입니다. 대중교통 객체에 유효 시간 간격이 설정되지 않은 경우 필수입니다.

오프셋 적용에 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다.

예를 들면 다음과 같습니다.

1985-04-12T23:20:50.52Z는 1985년 4월 12일 23시 20분 50.52초(UTC 기준)입니다.

1985-04-12T19:20:50.52-04:00은 UTC보다 4시간 늦은 1985년 4월 12일 19시 20분 50.52초입니다(위의 예시와 같은 시점). 이벤트가 뉴욕에서 진행된다면 이 시간은 미 동부 하계 표준시(EDT)에 해당합니다. 일광 절약 시간(서머타임)을 시행하는 지역에서는 연중 시점에 따라 오프셋이 다르게 적용된다는 점에 유의하세요.

1985-04-12T19:20:50.52는 오프셋 정보가 없는 1985년 4월 12일 19시 20분 50.52초입니다.

오프셋이 없는 날짜/시간 부분은 '현지 날짜/시간'으로 간주되며 출발지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 출발이 출발지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은 2018-06-05T20:00:00이어야 합니다. 출발지 정거장의 현지 날짜/시간이 UTC보다 4시간 느리다면 오프셋 -04:00을 추가할 수 있습니다.

오프셋 정보가 없으면 고급 기능 중 일부를 사용하지 못할 수 있습니다.

arrival_date_time

string

도착 날짜/시간입니다.

오프셋 적용에 관계없이 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 초 단위 오프셋은 ISO 8601의 일부는 아니지만 오프셋을 초 단위로 지정할 수 있습니다.

예를 들면 다음과 같습니다.

1985-04-12T23:20:50.52Z는 1985년 4월 12일 23시 20분 50.52초(UTC 기준)입니다.

1985-04-12T19:20:50.52-04:00은 UTC보다 4시간 늦은 1985년 4월 12일 19시 20분 50.52초입니다(위의 예시와 같은 시점). 이벤트가 뉴욕에서 진행된다면 이 시간은 미 동부 하계 표준시(EDT)에 해당합니다. 일광 절약 시간(서머타임)을 시행하는 지역에서는 연중 시점에 따라 오프셋이 다르게 적용된다는 점에 유의하세요.

1985-04-12T19:20:50.52는 오프셋 정보가 없는 1985년 4월 12일 19시 20분 50.52초입니다.

오프셋이 없는 날짜/시간 부분은 '현지 날짜/시간'으로 간주되며 목적지 정거장의 현지 날짜/시간이어야 합니다. 예를 들어 이벤트가 목적지 정거장에서 2018년 6월 5일 20시에 발생한다면 현지 날짜/시간 부분은 2018-06-05T20:00:00이어야 합니다. 목적지 정거장의 현지 날짜/시간이 UTC보다 4시간 느리다면 오프셋 -04:00을 추가할 수 있습니다.

오프셋 정보가 없으면 고급 기능 중 일부를 사용하지 못할 수 있습니다.

fare_name

LocalizedString

이 여행 구간의 요금에 대한 간단한 설명/이름입니다. 예: '언제든 일회 사용'

carriage

string

승객이 탑승해야 하는 열차 또는 선박 이름/번호입니다.

platform

string

승객이 탑승할 수 있는 플랫폼 또는 게이트입니다.

zone

string

플랫폼 내 탑승 구역입니다.

ticket_seat

TicketSeat

승객 예약석입니다. 좌석을 두 개 이상 지정하려면 ticketSeats 필드를 대신 사용하세요. ticketSeatticketSeats를 모두 설정할 수는 없습니다.

ticket_seats[]

TicketSeat

승객 예약석입니다. 좌석을 하나만 지정하려면 ticketSeat 필드를 대신 사용하세요. ticketSeatticketSeats를 모두 설정할 수는 없습니다.

transit_operator_name

LocalizedString

이 여행 구간을 운영하는 대중교통 운영자의 이름입니다.

transit_terminus_name

LocalizedString

열차/버스 등의 종점 정거장 또는 목적지입니다.

TicketRestrictions

필드
route_restrictions

LocalizedString

이용 가능한 노선에 대한 제한입니다. 예를 들어 '예약된 CrossCountry 열차 전용'일 수 있습니다.

route_restrictions_details

LocalizedString

위의 routeRestrictions에 대한 세부정보입니다.

time_restrictions

LocalizedString

이 티켓을 사용할 수 있는 시간에 대한 제한입니다.

other_restrictions

LocalizedString

'노선' 또는 '시간' 카테고리에 포함되지 않는 추가 제한 사항입니다.

TicketSeat

필드
fare_class

FareClass

발권된 좌석의 요금 등급입니다.

custom_fare_class

LocalizedString

fareClass가 적용되지 않는 경우 사용할 고객 요금 등급입니다. fareClasscustomFareClass를 모두 설정할 수는 없습니다.

coach

string

발권된 좌석이 위치한 열차 또는 객차의 식별자입니다. 예: '10'

seat

string

발권된 좌석이 위치한 곳의 식별자입니다. 예: '42'. 특정 식별자가 없는 경우 seatAssigment를 대신 사용하세요.

seat_assignment

LocalizedString

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

FareClass

열거형
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

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

FIRST
first

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

BUSINESS
business

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

TransitClass

필드
transit_operator_name

LocalizedString

대중교통 운영자 이름입니다.

transit_type

TransitType

필수. 이 클래스가 나타내는 대중교통 유형입니다. 예: '버스'

watermark

Image

사용자 기기에 표시할 워터마크 이미지입니다.

language_override

string

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

custom_transit_terminus_name_label

LocalizedString

대중교통 종착역 이름 값(transitObject.ticketLeg.transitTerminusName)에 사용할 맞춤 라벨입니다.

custom_ticket_number_label

LocalizedString

티켓 번호 값(transitObject.ticketNumber)에 사용할 맞춤 라벨입니다.

custom_route_restrictions_label

LocalizedString

노선 제한 값(transitObject.ticketRestrictions.routeRestrictions)에 사용할 맞춤 라벨입니다.

custom_route_restrictions_details_label

LocalizedString

노선 제한 세부정보 값(transitObject.ticketRestrictions.routeRestrictionsDetails)에 사용할 맞춤 라벨입니다

custom_time_restrictions_label

LocalizedString

시간 제한 세부정보 값(transitObject.ticketRestrictions.timeRestrictions)에 사용할 맞춤 라벨입니다.

custom_other_restrictions_label

LocalizedString

다른 제한 값(transitObject.ticketRestrictions.otherRestrictions)에 사용할 맞춤 라벨입니다.

custom_purchase_receipt_number_label

LocalizedString

구매 영수증 번호 값(transitObject.purchaseDetails.purchaseReceiptNumber)에 사용할 맞춤 라벨입니다.

custom_confirmation_code_label

LocalizedString

확인 코드 값(transitObject.purchaseDetails.confirmationCode)에 사용할 맞춤 라벨입니다.

custom_purchase_face_value_label

LocalizedString

구매 액면가(transitObject.purchaseDetails.ticketCost.faceValue)에 사용할 맞춤 라벨입니다.

custom_purchase_price_label

LocalizedString

구매 가격 값(transitObject.purchaseDetails.ticketCost.purchasePrice)에 사용할 맞춤 라벨입니다.

custom_discount_message_label

LocalizedString

대중교통 할인 메시지 값(transitObject.purchaseDetails.ticketCost.discountMessage)에 사용할 맞춤 라벨입니다.

custom_carriage_label

LocalizedString

캐리지 값(transitObject.ticketLeg.carriage)에 사용할 맞춤 라벨입니다.

custom_seat_label

LocalizedString

좌석 위치 값(transitObject.ticketLeg.ticketSeat.seat)에 사용할 맞춤 라벨입니다.

custom_coach_label

LocalizedString

객차 값(transitObject.ticketLeg.ticketSeat.coach)에 사용할 맞춤 라벨입니다.

custom_platform_label

LocalizedString

탑승 플랫폼 값(transitObject.ticketLeg.platform)에 사용할 맞춤 라벨입니다.

custom_zone_label

LocalizedString

탑승 구역 값(transitObject.ticketLeg.zone)에 사용할 맞춤 라벨입니다.

custom_fare_class_label

LocalizedString

요금 등급 값(transitObject.ticketLeg.ticketSeat.fareClass)에 사용할 맞춤 라벨입니다.

custom_concession_category_label

LocalizedString

대중교통 할인 카테고리 값(transitObject.concessionCategory)에 사용할 맞춤 라벨입니다.

custom_fare_name_label

LocalizedString

대중교통 요금 이름 값(transitObject.ticketLeg.fareName)에 사용할 맞춤 라벨입니다.

class_template_info

ClassTemplateInfo

클래스를 표시하는 방법에 대한 템플릿 정보입니다. 설정하지 않으면 Google은 기본 필드 모음을 대신 표시합니다.

enable_single_leg_itinerary

bool

이 클래스의 단일 구간 운항 일정 표시를 제어합니다. 기본적으로 운항 일정은 다중 구간 여행에만 표시됩니다.

id

string

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

version
(deprecated)

int64

지원 중단됨

issuer_name

string

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

messages[]

Message

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

allow_multiple_users_per_object
(deprecated)

bool

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

homepage_uri

Uri

애플리케이션 홈페이지 URI입니다. 이 필드에 URI를 채우면 linksModuleData에 URI를 채우는 것과 동일한 동작이 실행됩니다(객체를 렌더링할 때 홈페이지 링크는 일반적으로 객체의 linksModuleData 섹션으로 간주되는 항목에 표시됩니다).

locations[]

LatLongPoint

review_status

ReviewStatus

필수. 클래스 상태입니다. insert, patch 또는 update API 호출을 사용하여 이 필드를 draft 또는 underReview로 설정할 수 있습니다. 검토 상태가 draft에서 다른 상태로 변경되면 다시 draft로 변경할 수 없습니다.

클래스를 개발 중일 때는 이 필드를 draft로 유지해야 합니다. draft 클래스는 객체를 만드는 데 사용할 수 없습니다.

클래스를 사용할 준비가 되면 이 필드를 underReview로 설정해야 합니다. 플랫폼은 이 필드를 자동으로 approved로 설정하며 이는 객체를 생성하거나 마이그레이션하는 데 즉시 사용 가능합니다.

이미 approved된 클래스를 업데이트하는 경우 필드의 설정을 underReview로 유지해야 합니다.

review

Review

클래스가 approved 또는 rejected로 표시되는 경우 플랫폼에서 설정한 검토 주석입니다.

info_module_data
(deprecated)

InfoModuleData

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

image_modules_data[]

ImageModuleData

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

text_modules_data[]

TextModuleData

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

redemption_issuers[]

int64

스마트 탭 사용 파트너에게만 제공됩니다. 자세한 안내는 지원팀에 문의하세요.

country_code

string

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

hero_image

Image

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

word_mark
(deprecated)

Image

지원 중단되었습니다.

enable_smart_tap

bool

스마트 탭 사용 파트너에게만 제공됩니다. 자세한 안내는 지원팀에 문의하세요.

hex_background_color

string

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

localized_issuer_name

LocalizedString

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

multiple_devices_and_holders_allowed_status

MultipleDevicesAndHoldersAllowedStatus

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

callback_options

CallbackOptions

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

TransitType

열거형
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

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

RAIL
rail

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

TRAM
tram

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

FERRY
ferry

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

OTHER
other

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

TransitClassAddMessageRequest

필드
resource_id

string

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

add_message_request

AddMessageRequest

요청 본문입니다.

TransitClassAddMessageResponse

필드
resource

TransitClass

업데이트된 TransitClass 리소스입니다.

TransitClassGetRequest

필드
resource_id

string

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

TransitClassInsertRequest

필드
resource

TransitClass

요청 본문입니다.

TransitClassListRequest

필드
issuer_id

int64

클래스를 나열하도록 승인된 발급기관의 ID입니다.

token

string

maxResults를 지정했지만 목록에 maxResults보다 더 많은 클래스가 있을 경우 다음 결과 집합을 가져오는 데 사용됩니다. 예를 들어 클래스가 200개인 목록이 있는데 maxResults를 20으로 설정하고 목록을 호출하면 목록은 처음 20개의 클래스와 토큰 하나를 반환합니다. 다음 20개 클래스를 가져오려면 maxResults를 20으로 설정하고 반환된 토큰을 사용하여 목록을 다시 호출합니다.

max_results

int32

목록에서 반환하는 결과의 최대 개수를 식별합니다. maxResults를 정의하지 않으면 모든 결과가 반환됩니다.

TransitClassListResponse

필드
resources[]

TransitClass

목록 요청에 해당하는 리소스입니다.

pagination

Pagination

응답의 페이지 나누기입니다.

TransitClassPatchRequest

필드
resource_id

string

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

resource

TransitClass

요청 본문입니다.

TransitClassUpdateRequest

필드
resource_id

string

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

resource

TransitClass

요청 본문입니다.

TransitObject

필드
class_reference

TransitClass

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

ticket_number

string

티켓 번호입니다. 대중교통 운영 시스템에서 티켓의 고유 식별자입니다.

passenger_type

PassengerType

승객 수입니다.

passenger_names

string

티켓이 할당된 승객의 이름입니다. 위의 passengerType 필드는 Google에 이 필드에 대한 컨텍스트를 제공하기 위한 것입니다.

trip_id

string

사용자가 동일한 여행에 대해 여러 티켓을 저장한 경우 이 ID는 티켓을 그룹화하는 데 사용됩니다.

ticket_status

TicketStatus

티켓의 상태입니다. 표시에 영향을 미치는 상태의 경우 state 필드를 대신 사용하세요.

custom_ticket_status

LocalizedString

ticketStatus가 올바른 옵션을 제공하지 않는 경우 티켓 상태 값에 사용할 맞춤 상태입니다. ticketStatuscustomTicketStatus를 모두 설정할 수는 없습니다.

concession_category

ConcessionCategory

티켓의 할인 카테고리입니다.

custom_concession_category

LocalizedString

concessionCategory가 올바른 옵션을 제공하지 않는 경우 사용할 맞춤 할인 카테고리입니다. concessionCategorycustomConcessionCategory를 모두 설정할 수는 없습니다.

ticket_restrictions

TicketRestrictions

이 티켓 사용에 적용되는 제한의 종류에 대한 정보입니다. 예를 들어 사용해야 하는 요일 또는 취할 수 있는 노선 등입니다.

purchase_details

PurchaseDetails

이 티켓의 구매 세부정보입니다.

ticket_leg

TicketLeg

단일 티켓 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 두 개 이상 지정하려면 ticketLegs 필드를 대신 사용하세요. ticketLegticketLegs를 모두 설정할 수는 없습니다.

ticket_legs[]

TicketLeg

각 티켓에는 하나 이상의 구간이 포함될 수 있습니다. 각 구간에는 탑승 및 좌석 정보와 함께 출발 및 도착 정보가 포함됩니다. 구간을 하나만 지정하려면 ticketLeg 필드를 대신 사용하세요. ticketLegticketLegs를 모두 설정할 수는 없습니다.

hex_background_color

string

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

trip_type

TripType

필수. 이 대중교통 객체가 나타내는 여행의 유형입니다. 출발지와 목적지 사이에 사용할 기호를 결정하는 데 사용됩니다.

id

string

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

class_id

string

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

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

version
(deprecated)

int64

지원 중단됨

state

State

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

barcode

Barcode

바코드 유형 및 값입니다.

messages[]

Message

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

valid_time_interval

TimeInterval

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

locations[]

LatLongPoint

객체를 사용할 수 있는 위치의 목록입니다. 플랫폼은 이 정보를 사용하여 사용자에게 위치정보 알림을 트리거합니다. 위치 우선순위는 객체의 위치, 클래스의 위치, Google 지역 정보 ID의 위치 순입니다.

has_users

bool

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

smart_tap_redemption_value

string

스마트 탭 사용 파트너에게만 제공됩니다. 자세한 안내는 지원팀에 문의하세요.

has_linked_device

bool

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

disable_expiration_notification

bool

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

현재 이 속성은 쿠폰에만 설정할 수 있습니다.

info_module_data

InfoModuleData

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

image_modules_data[]

ImageModuleData

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

text_modules_data[]

TextModuleData

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

ConcessionCategory

열거형
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

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

CHILD
child

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

SENIOR
senior

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

PassengerType

열거형
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

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

MULTIPLE_PASSENGERS
multiplePassengers

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

TicketStatus

열거형
TICKET_STATUS_UNSPECIFIED
USED
used

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

REFUNDED
refunded

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

EXCHANGED
exchanged

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

TripType

열거형
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

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

ONE_WAY
oneWay

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

TransitObjectAddMessageRequest

필드
resource_id

string

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

add_message_request

AddMessageRequest

요청 본문입니다.

TransitObjectAddMessageResponse

필드
resource

TransitObject

업데이트된 TransitObject 리소스입니다.

TransitObjectGetRequest

필드
resource_id

string

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

TransitObjectInsertRequest

필드
resource

TransitObject

요청 본문입니다.

TransitObjectListRequest

필드
class_id

string

객체 목록을 확인할 클래스의 ID입니다.

token

string

maxResults를 지정했지만 목록에 maxResults보다 더 많은 객체가 있을 경우 다음 결과 집합을 가져오는 데 사용됩니다. 예를 들어 목록에 200개의 객체가 있는데 maxResults를 20으로 설정하여 list를 호출하면 처음 20개의 객체와 토큰 하나가 반환됩니다. 다음 20개 객체를 가져오려면 maxResults를 20으로 설정하고 반환된 토큰을 사용하여 목록을 다시 호출합니다.

max_results

int32

목록에서 반환하는 결과의 최대 개수를 식별합니다. maxResults를 정의하지 않으면 모든 결과가 반환됩니다.

TransitObjectListResponse

필드
resources[]

TransitObject

목록 요청에 해당하는 리소스입니다.

pagination

Pagination

응답의 페이지 나누기입니다.

TransitObjectPatchRequest

필드
resource_id

string

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

resource

TransitObject

요청 본문입니다.

TransitObjectUpdateRequest

필드
resource_id

string

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

resource

TransitObject

요청 본문입니다.