Pakiet google.walletobjects.v1.transit

Indeks

TransitClassService

AddMessage

rpc AddMessage(TransitClassAddMessageRequest) returns (TransitClassAddMessageResponse)

Dodaje wiadomość do klasy biletu, do której odwołuje się podany identyfikator klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Get(TransitClassGetRequest) returns (TransitClass)

Zwraca klasę biletu z podanym identyfikatorem klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Insert(TransitClassInsertRequest) returns (TransitClass)

Wstawia klasę biletu z podanym identyfikatorem i właściwościami.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc List(TransitClassListRequest) returns (TransitClassListResponse)

Zwraca listę wszystkich klas biletu dla podanego identyfikatora wydawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Patch(TransitClassPatchRequest) returns (TransitClass)

Aktualizuje klasę biletu, do której odwołuje się podany identyfikator klasy. Ta metoda obsługuje semantykę poprawki.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Update(TransitClassUpdateRequest) returns (TransitClass)

Aktualizuje klasę biletu, do której odwołuje się podany identyfikator klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

TransitObjectService

AddMessage

rpc AddMessage(TransitObjectAddMessageRequest) returns (TransitObjectAddMessageResponse)

Dodaje wiadomość do obiektu biletu, do którego odwołuje się podany identyfikator obiektu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Get(TransitObjectGetRequest) returns (TransitObject)

Zwraca obiekt biletu z podanym identyfikatorem obiektu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Insert(TransitObjectInsertRequest) returns (TransitObject)

Wstawia obiekt biletu z podanym identyfikatorem i właściwościami.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc List(TransitObjectListRequest) returns (TransitObjectListResponse)

Zwraca listę wszystkich obiektów biletu dla podanego identyfikatora wydawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Patch(TransitObjectPatchRequest) returns (TransitObject)

Aktualizuje obiekt biletu, do którego odwołuje się podany identyfikator obiektu. Ta metoda obsługuje semantykę poprawki.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc Update(TransitObjectUpdateRequest) returns (TransitObject)

Aktualizuje obiekt biletu, do którego odwołuje się podany identyfikator obiektu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

PurchaseDetails

Pola
purchase_receipt_number

string

Numer rachunku / identyfikator do śledzenia zakupu biletu przez podmiot, który sprzedał bilet.

purchase_date_time

string

Data i godzina zakupu biletu.

Są to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia lub z przesunięciem. Godzinę można określić z dokładnością do nanosekundy. Przesunięcia można określić z dokładnością do sekundy (pomimo że przesunięcie takie nie jest objęte normą ISO 8601).

Na przykład:

W UTC 1985-04-12T23:20:50.52Z to 20 minut i 50,52 sekundy po godzinie 23 w dniu 12 kwietnia 1985 roku.

1985-04-12T19:20:50.52-04:00 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku, 4 godziny przed UTC (ta sama chwila co w przykładzie powyżej). Gdyby wydarzenie odbyło się w Nowym Jorku, byłby to odpowiednik czasu letniego wschodnioamerykańskiego (EDT). Pamiętaj, że przesunięcie jest różne w regionach, w których obowiązuje czas letni, w zależności od pory roku.

1985-04-12T19:20:50.52 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku bez informacji o przesunięciu.

Bez informacji o przesunięciu niektóre rozszerzone funkcje mogą być niedostępne.

account_id

string

Identyfikator konta użytego do zakupu biletu.

confirmation_code

string

Kod potwierdzający zakup. Może być taki sam dla wielu różnych biletów i służy do grupowania biletów.

ticket_cost

TicketCost

Koszt biletu.

TicketCost

Pola
face_value

Money

Wartość nominalna biletu.

purchase_price

Money

Rzeczywista cena zakupu biletu, po opodatkowaniu i z uwzględnieniem rabatów.

discount_message

LocalizedString

Komunikat opisujący każdy zastosowany rabat.

TicketLeg

Pola
origin_station_code

string

Kod stacji początkowej. Pole jest wymagane, jeśli podano destinationStationCode lub nie ma originName.

origin_name

LocalizedString

Nazwa stacji początkowej. Pole jest wymagane, jeśli podano desinationName lub nie ma originStationCode.

destination_station_code

string

Kod stacji docelowej.

destination_name

LocalizedString

Nazwa miejsca docelowego.

departure_date_time

string

Data i godzina wyjazdu. Pole jest wymagane, jeśli dla obiektu biletu nie określono przedziału czasu ważności.

Są to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia lub z przesunięciem. Godzinę można określić z dokładnością do nanosekundy. Przesunięcia można określić z dokładnością do sekundy (pomimo że przesunięcie takie nie jest objęte normą ISO 8601).

Na przykład:

W UTC 1985-04-12T23:20:50.52Z to 20 minut i 50,52 sekundy po godzinie 23 w dniu 12 kwietnia 1985 roku.

1985-04-12T19:20:50.52-04:00 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku, 4 godziny przed UTC (ta sama chwila co w przykładzie powyżej). Gdyby wydarzenie odbyło się w Nowym Jorku, byłby to odpowiednik czasu letniego wschodnioamerykańskiego (EDT). Pamiętaj, że przesunięcie jest różne w regionach, w których obowiązuje czas letni, w zależności od pory roku.

1985-04-12T19:20:50.52 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku bez informacji o przesunięciu.

Część daty i godziny bez przesunięcia jest uważana za „lokalną datę i godzinę”. Powinny to być lokalna data i godzina na stacji początkowej. Jeśli na przykład wyjazd ze stacji początkowej ma nastąpić o godzinie 20 dnia 5 czerwca 2018 roku, lokalną datą i godziną powinno być 2018-06-05T20:00:00. Jeśli lokalna data i godzina na stacji początkowej przypadają 4 godziny przed UTC, można dołączyć przesunięcie o -04:00.

Bez informacji o przesunięciu niektóre rozszerzone funkcje mogą być niedostępne.

arrival_date_time

string

Data i godzina przyjazdu.

Są to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia lub z przesunięciem. Godzinę można określić z dokładnością do nanosekundy. Przesunięcia można określić z dokładnością do sekundy (pomimo że przesunięcie takie nie jest objęte normą ISO 8601).

Na przykład:

W UTC 1985-04-12T23:20:50.52Z to 20 minut i 50,52 sekundy po godzinie 23 w dniu 12 kwietnia 1985 roku.

1985-04-12T19:20:50.52-04:00 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku, 4 godziny przed UTC (ta sama chwila co w przykładzie powyżej). Gdyby wydarzenie odbyło się w Nowym Jorku, byłby to odpowiednik czasu letniego wschodnioamerykańskiego (EDT). Pamiętaj, że przesunięcie jest różne w regionach, w których obowiązuje czas letni, w zależności od pory roku.

1985-04-12T19:20:50.52 to 20 minut i 50,52 sekundy po godzinie 19 w dniu 12 kwietnia 1985 roku bez informacji o przesunięciu.

Część daty i godziny bez przesunięcia jest uważana za „lokalną datę i godzinę”. Powinny to być lokalna data i godzina na stacji początkowej. Jeśli na przykład wydarzenie ma nastąpić na stacji docelowej o godzinie 20 dnia 5 czerwca 2018 roku, lokalną datą i godziną powinno być 2018-06-05T20:00:00. Jeśli lokalna data i godzina na stacji docelowej przypadają 4 godziny przed UTC, można dołączyć przesunięcie o -04:00.

Bez informacji o przesunięciu niektóre rozszerzone funkcje mogą być niedostępne.

fare_name

LocalizedString

Krótki opis lub nazwa opłaty za ten odcinek podróży. Np. „Dowolna godzina, jednorazowy”.

carriage

string

Nazwa lub numer pociągu albo statku, na który pasażer musi wejść.

platform

string

Peron lub brama, gdzie pasażer może wsiąść na statek lub do pociągu.

zone

string

Strefa wsiadania do pociągu w obrębie peronu.

ticket_seat

TicketSeat

Miejsce zarezerwowane dla pasażera lub pasażerów. Jeśli chcesz określić więcej niż jedno miejsce, użyj pola ticketSeats. Nie można ustawić jednocześnie wartości ticketSeat i ticketSeats.

ticket_seats[]

TicketSeat

Miejsce zarezerwowane dla pasażera lub pasażerów. Jeśli chcesz określić tylko jedno miejsce, użyj pola ticketSeat. Nie można ustawić jednocześnie wartości ticketSeat i ticketSeats.

transit_operator_name

LocalizedString

Nazwa operatora transportu publicznego obsługującego ten etap podróży.

transit_terminus_name

LocalizedString

Stacja końcowa lub miejsce docelowe pociągu, autokaru itp.

TicketRestrictions

Pola
route_restrictions

LocalizedString

Ograniczenia dotyczące możliwych tras. Na przykład może to być tekst „Tylko pociągi dalekobieżne z rezerwacją miejsc”.

route_restrictions_details

LocalizedString

Więcej informacji o powyższym routeRestrictions.

time_restrictions

LocalizedString

Ograniczenia dotyczące czasu wykorzystania tego biletu.

other_restrictions

LocalizedString

Dodatkowe ograniczenia, które nie należą do kategorii „trasy” ani „czasu”.

TicketSeat

Pola
fare_class

FareClass

Klasa taryfy biletowanego miejsca.

custom_fare_class

LocalizedString

Niestandardowa klasa taryfy, którą należy zastosować, gdy fareClass nie ma zastosowania. Nie można ustawić jednocześnie wartości fareClass i customFareClass.

coach

string

Identyfikator wagonu lub autokaru, w którym znajduje się biletowane miejsce. Przykład: „10”

seat

string

Identyfikator miejsca, w którym znajduje się biletowane miejsce. Przykład: „42”. Jeśli nie ma określonego identyfikatora, zamiast tego użyj seatAssigment.

seat_assignment

LocalizedString

Przypisanie miejsca pasażera. Przykład: „brak określonego miejsca”. Należy używać, gdy w seat nie ma konkretnego identyfikatora.

FareClass

Wyliczenia
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

Starsza wersja aliasu dla ECONOMY. Wycofano.

FIRST
first

Starsza wersja aliasu dla FIRST. Wycofano.

BUSINESS
business

Starsza wersja aliasu dla BUSINESS. Wycofano.

TransitClass

Pola
transit_operator_name

LocalizedString

Nazwa operatora transportu publicznego.

transit_type

TransitType

Wymagane. Rodzaj transportu, jaki reprezentuje ta klasa, na przykład „autobus”.

watermark

Image

Obraz znaku wodnego wyświetlany na urządzeniu użytkownika.

language_override

string

Jeśli to pole jest obecne, bilety transportu publicznego udostępniane na urządzeniu użytkownika będą zawsze wyświetlane w tym języku. Reprezentuje tag języka zgodny ze standardem BCP 47. Przykładowe wartości to „en-US”, „en-GB”, „de” lub „de-AT”.

custom_transit_terminus_name_label

LocalizedString

Własna etykieta dla wartości nazwy punktu końcowego (transitObject.ticketLeg.transitTerminusName).

custom_ticket_number_label

LocalizedString

Własna etykieta dla wartości numeru biletu (transitObject.ticketNumber).

custom_route_restrictions_label

LocalizedString

Własna etykieta dla wartości ograniczeń trasy (transitObject.ticketRestrictions.routeRestrictions).

custom_route_restrictions_details_label

LocalizedString

Własna etykieta dla wartości szczegółów ograniczeń trasy (transitObject.ticketRestrictions.routeRestrictionsDetails).

custom_time_restrictions_label

LocalizedString

Własna etykieta dla wartości szczegółów ograniczeń czasowych (transitObject.ticketRestrictions.timeRestrictions).

custom_other_restrictions_label

LocalizedString

Własna etykieta dla wartości innych ograniczeń (transitObject.ticketRestrictions.otherRestrictions).

custom_purchase_receipt_number_label

LocalizedString

Własna etykieta dla wartości numeru potwierdzenia zakupu (transitObject.purchaseDetails.purchaseReceiptNumber).

custom_confirmation_code_label

LocalizedString

Własna etykieta dla wartości kodu potwierdzenia (transitObject.purchaseDetails.confirmationCode).

custom_purchase_face_value_label

LocalizedString

Własna etykieta dla wartości nominalnej zakupu (transitObject.purchaseDetails.ticketCost.faceValue).

custom_purchase_price_label

LocalizedString

Własna etykieta dla wartości ceny zakupu (transitObject.purchaseDetails.ticketCost.purchasePrice).

custom_discount_message_label

LocalizedString

Własna etykieta dla wartości komunikatu rabatu na transport publiczny (transitObject.purchaseDetails.ticketCost.discountMessage).

custom_carriage_label

LocalizedString

Własna etykieta dla wartości przewozu (transitObject.ticketLeg.carriage).

custom_seat_label

LocalizedString

Własna etykieta dla wartości lokalizacji miejsca (transitObject.ticketLeg.ticketSeat.seat).

custom_coach_label

LocalizedString

Własna etykieta dla wartości wagonu (transitObject.ticketLeg.ticketSeat.coach).

custom_platform_label

LocalizedString

Własna etykieta dla wartości peronu wejścia na pokład (transitObject.ticketLeg.platform).

custom_zone_label

LocalizedString

Własna etykieta dla wartości strefy wejścia na pokład (transitObject.ticketLeg.zone).

custom_fare_class_label

LocalizedString

Własna etykieta dla wartości klasy biletu (transitObject.ticketLeg.ticketSeat.fareClass).

custom_concession_category_label

LocalizedString

Własna etykieta dla wartości kategorii ulg na transport publiczny (transitObject.concessionCategory).

custom_fare_name_label

LocalizedString

Własna etykieta dla wartości nazwy taryfy transportu publicznego (transitObject.ticketLeg.fareName).

class_template_info

ClassTemplateInfo

Informacje na temat szablonu wyświetlania klasy. Jeśli nie są ustawione, Google przyjmuje domyślny zestaw pól do wyświetlenia.

enable_single_leg_itinerary

bool

Steruje wyświetlaniem planu podróży jednoetapowej w tej klasie. Domyślnie plan podróży wyświetla się tylko w przypadku podróży wieloetapowej.

id

string

Wymagane. Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

version
(deprecated)

int64

Wycofano

issuer_name

string

Wymagane. Nazwa wydawcy. Zalecana maksymalna długość to 20 znaków, co zapewnia możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.

messages[]

Message

Tablica komunikatów wyświetlanych w aplikacji. Wszyscy użytkownicy tego obiektu będą otrzymywać powiązane z nim komunikaty. Maksymalna liczba tych pól to 10.

allow_multiple_users_per_object
(deprecated)

bool

Wycofano. Zamiast niego użyj multipleDevicesAndHoldersAllowedStatus.

homepage_uri

Uri

Identyfikator URI strony głównej aplikacji. Wypełnienie identyfikatora URI ma taki sam efekt jak wypełnienie identyfikatora URI w linksModuleData (gdy obiekt jest renderowany, link do strony głównej jest widoczny w miejscu, które można określić jako sekcja linksModuleData obiektu).

locations[]

LatLongPoint

review_status

ReviewStatus

Wymagane. Stan klasy. To pole można ustawić na draft lub underReview za pomocą wywołań API insert, patch lub update. Po zmianie stanu weryfikacji draft na inny nie można go zmienić z powrotem na draft.

Należy zachować stan draft, gdy klasa jest w fazie rozwoju. Klasy w stanie draft nie można użyć do utworzenia żadnego obiektu.

Gdy uznasz, że klasa jest gotowa do użycia, ustaw to pole na underReview. Platforma automatycznie ustawi to pole na approved i będzie można go natychmiast używać do tworzenia lub migrowania obiektów.

Aktualizując klasę, która jest już w stanie approved, należy ustawiać to pole na underReview.

review

Review

Komentarze do weryfikacji ustawione przez platformę, gdy klasa jest oznaczona jako approved lub rejected.

info_module_data
(deprecated)

InfoModuleData

Wycofano. W zamian używaj textModulesData.

image_modules_data[]

ImageModuleData

Dane modułu obrazu. Maksymalna liczba wyświetlanych pól wynosi 1 z poziomu obiektu i 1 dla poziomu obiektu klasy.

text_modules_data[]

TextModuleData

Dane modułu tekstowego. Jeśli dane modułu tekstowego są określone również w klasie, będą wyświetlane jedne i drugie. Maksymalna liczba wyświetlanych pól wynosi 10 z obiektu i 10 z klasy.

redemption_issuers[]

int64

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.

country_code

string

Kod kraju używany do wyświetlania kraju karty (gdy użytkownik nie przebywa w tym kraju), a także do wyświetlania zlokalizowanej treści, gdy treść nie jest dostępna w języku użytkownika.

hero_image

Image

Opcjonalny obraz banera wyświetlany z przodu karty. Jeśli go nie ma, nic nie jest wyświetlane. Obraz wyświetla się w 100% szerokości.

word_mark
(deprecated)

Image

Wycofano.

enable_smart_tap

bool

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.

hex_background_color

string

Kolor tła karty. Jeśli nie jest ustawiony, używany jest dominujący kolor obrazu banera powitalnego, a jeśli obraz banera powitalnego nie jest ustawiony, używany jest dominujący kolor logo. Format to #rrggbb, gdzie rrggbb to szesnastkowy zapis RGB, taki jak #ffcc00. Możesz także używać skróconej wersji zapisu RGB w formacie #rgb, jak w tym przykładzie: #fc0.

localized_issuer_name

LocalizedString

Przetłumaczony tekst pola issuer_name. Zalecana maksymalna długość to 20 znaków, co zapewnia możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.

multiple_devices_and_holders_allowed_status

MultipleDevicesAndHoldersAllowedStatus

Wskazuje, czy wielu użytkowników i urządzeń zapisze ten sam obiekt odwołujący się do tej klasy.

callback_options

CallbackOptions

Opcje wywołania zwrotnego, które mają być używane do wywoływania wydawcy przy każdym zapisie/usunięciu obiektu tej klasy przez użytkownika końcowego. Wszystkie obiekty tej klasy są odpowiednie dla wywołania zwrotnego.

TransitType

Wyliczenia
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

Starsza wersja aliasu dla BUS. Wycofano.

RAIL
rail

Starsza wersja aliasu dla RAIL. Wycofano.

TRAM
tram

Starsza wersja aliasu dla TRAM. Wycofano.

FERRY
ferry

Starsza wersja aliasu dla FERRY. Wycofano.

OTHER
other

Starsza wersja aliasu dla OTHER. Wycofano.

TransitClassAddMessageRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

add_message_request

AddMessageRequest

Treść żądania.

TransitClassAddMessageResponse

Pola
resource

TransitClass

Zaktualizowany zasób TransitClass.

TransitClassGetRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

TransitClassInsertRequest

Pola
resource

TransitClass

Treść żądania.

TransitClassListRequest

Pola
issuer_id

int64

Identyfikator wydawcy autoryzowanego do wyświetlenia listy klas.

token

string

Umożliwia uzyskanie następnego zestawu wyników, jeśli określono maxResults, ale liczba klas dostępnych na liście jest większa niż maxResults. Jeśli na przykład na liście jest 200 klas i wywołujesz listę z wartością maxResults ustawioną na 20, lista zwróci pierwsze 20 klas i token. Wywołaj ponownie listę z wartością maxResults ustawioną na 20 i tokenem, aby uzyskać kolejne 20 klas.

max_results

int32

Określa maksymalną liczbę wyników zwracanych przez listę. Jeśli wartość maxResults nie jest zdefiniowana, zwracane są wszystkie wyniki.

TransitClassListResponse

Pola
resources[]

TransitClass

Zasoby odpowiadające żądaniu listy.

pagination

Pagination

Podział odpowiedzi na strony.

TransitClassPatchRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

resource

TransitClass

Treść żądania.

TransitClassUpdateRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

resource

TransitClass

Treść żądania.

TransitObject

Pola
class_reference

TransitClass

Kopia dziedziczonych pól klasy nadrzędnej. Te pola są pobierane podczas żądania GET.

ticket_number

string

Numer biletu. Jest to unikalny identyfikator biletu w systemie operatora transportu publicznego.

passenger_type

PassengerType

Liczba pasażerów.

passenger_names

string

Nazwiska pasażerów, którym przydzielono bilet. Opisane wyżej pole passengerType ma dać Google kontekst dla tego pola.

trip_id

string

Ten identyfikator służy do grupowania biletów, jeśli użytkownik zapisał więcej niż jeden bilet na tę samą podróż.

ticket_status

TicketStatus

Stan biletu. W przypadku stanów, które mają wpływ na wyświetlanie, użyj pola state.

custom_ticket_status

LocalizedString

Niestandardowy stan używany w przypadku wartości stanu biletu, gdy ticketStatus nie zawiera właściwej opcji. Nie można ustawić jednocześnie wartości ticketStatus i customTicketStatus.

concession_category

ConcessionCategory

Kategoria rodzaju ulgi na bilet.

custom_concession_category

LocalizedString

Niestandardowa kategoria ulgi, której należy użyć, gdy kategoria concessionCategory nie zawiera właściwej opcji. Nie można ustawić jednocześnie wartości concessionCategory i customConcessionCategory.

ticket_restrictions

TicketRestrictions

Informacje o ograniczeniach dotyczących korzystania z tego biletu. Na przykład w które dni tygodnia należy go używać lub jakie trasy można pokonywać.

purchase_details

PurchaseDetails

Szczegóły zakupu biletu.

ticket_leg

TicketLeg

Pojedynczy odcinek biletu zawiera informacje na temat odjazdu i przyjazdu, wejścia na pokład oraz przydzielonego miejsca. Jeśli chcesz określić więcej niż jeden odcinek biletu, użyj pola ticketLegs. Nie można ustawić jednocześnie wartości ticketLeg i ticketLegs.

ticket_legs[]

TicketLeg

Każdy bilet może zawierać jeden lub więcej odcinków. Każdy odcinek biletu zawiera informacje na temat odjazdu i przyjazdu, wejścia na pokład oraz przydzielonego miejsca. Jeśli chcesz określić tylko jeden odcinek, użyj pola ticketLeg. Nie można ustawić jednocześnie wartości ticketLeg i ticketLegs.

hex_background_color

string

Kolor tła karty. Jeśli nie jest ustawiony, używany jest dominujący kolor obrazu banera powitalnego, a jeśli obraz banera powitalnego nie jest ustawiony, używany jest dominujący kolor logo. Format to #rrggbb, gdzie rrggbb to szesnastkowy zapis RGB, taki jak #ffcc00. Możesz także używać skróconej wersji zapisu RGB w formacie #rgb, jak w tym przykładzie: #fc0.

trip_type

TripType

Wymagane. Typ podróży, którą reprezentuje ten obiekt biletu. Służy do określenia, który symbol ma być używany między miejscem początkowym i docelowym.

id

string

Wymagane. Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

class_id

string

Wymagane. Klasa powiązana z tym obiektem. Klasa musi być tego samego typu co ten obiekt, musi już istnieć i musi być zatwierdzona.

Identyfikatory klas powinny mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie.

version
(deprecated)

int64

Wycofano

state

State

Wymagane. Stan obiektu. To pole służy do określania sposobu wyświetlania obiektu w aplikacji. Na przykład obiekt inactive jest przenoszony do sekcji „Karty, które straciły ważność”.

barcode

Barcode

Typ i wartość kodu kreskowego.

messages[]

Message

Tablica komunikatów wyświetlanych w aplikacji. Wszyscy użytkownicy tego obiektu będą otrzymywać powiązane z nim komunikaty. Maksymalna liczba tych pól to 10.

valid_time_interval

TimeInterval

Okres, przez jaki ten obiekt będzie active i będzie można go używać. Po upływie tego czasu stan obiektu zostanie zmieniony na expired.

locations[]

LatLongPoint

Lista lokalizacji, w których można użyć obiektu. Platforma wykorzystuje te informacje do aktywowania powiadomień dla użytkowników przy użyciu geolokalizacji. Pamiętaj, że lokalizacje w obiekcie zastępują lokalizacje w klasie, które z kolei zastępują lokalizacje w identyfikatorze Miejsc Google.

has_users

bool

Wskazuje, czy obiekt ma użytkowników. To pole jest ustawiane przez platformę.

smart_tap_redemption_value

string

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.

has_linked_device

bool

Wskazuje, czy ten obiekt jest aktualnie połączony z jednym urządzeniem. To pole jest ustawiane przez platformę, gdy użytkownik zapisuje obiekt, łącząc go ze swoim urządzeniem. Przeznaczone do użytku przez wybranych partnerów. W przypadku wątpliwości skontaktuj się z działem pomocy.

disable_expiration_notification

bool

Wskazuje, czy powiadomienia powinny być jawnie pomijane. Jeśli to pole jest ustawione na wartość true, niezależnie od pola messages powiadomienia o utracie ważności kierowane do użytkownika będą pomijane. Domyślnie to pole jest ustawione na false.

Obecnie można je ustawiać tylko dla ofert specjalnych.

info_module_data

InfoModuleData

Wycofano. W zamian używaj textModulesData.

image_modules_data[]

ImageModuleData

Dane modułu obrazu. Maksymalna liczba wyświetlanych pól wynosi 1 z poziomu obiektu i 1 dla poziomu obiektu klasy.

text_modules_data[]

TextModuleData

Dane modułu tekstowego. Jeśli dane modułu tekstowego są określone również w klasie, będą wyświetlane jedne i drugie. Maksymalna liczba wyświetlanych pól wynosi 10 z obiektu i 10 z klasy.

ConcessionCategory

Wyliczenia
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

Starsza wersja aliasu dla ADULT. Wycofano.

CHILD
child

Starsza wersja aliasu dla CHILD. Wycofano.

SENIOR
senior

Starsza wersja aliasu dla SENIOR. Wycofano.

PassengerType

Wyliczenia
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

Starsza wersja aliasu dla SINGLE_PASSENGER. Wycofano.

MULTIPLE_PASSENGERS
multiplePassengers

Starsza wersja aliasu dla MULTIPLE_PASSENGERS. Wycofano.

TicketStatus

Wyliczenia
TICKET_STATUS_UNSPECIFIED
USED
used

Starsza wersja aliasu dla USED. Wycofano.

REFUNDED
refunded

Starsza wersja aliasu dla REFUNDED. Wycofano.

EXCHANGED
exchanged

Starsza wersja aliasu dla EXCHANGED. Wycofano.

TripType

Wyliczenia
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

Starsza wersja aliasu dla ROUND_TRIP. Wycofano.

ONE_WAY
oneWay

Starsza wersja aliasu dla ONE_WAY. Wycofano.

TransitObjectAddMessageRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

add_message_request

AddMessageRequest

Treść żądania.

TransitObjectAddMessageResponse

Pola
resource

TransitObject

Zaktualizowany zasób TransitObject.

TransitObjectGetRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

TransitObjectInsertRequest

Pola
resource

TransitObject

Treść żądania.

TransitObjectListRequest

Pola
class_id

string

Identyfikator klasy, której obiekty zostaną wyświetlone.

token

string

Umożliwia uzyskanie następnego zestawu wyników, jeśli określono maxResults, ale liczba obiektów dostępnych na liście jest większa niż maxResults. Jeśli na przykład na liście jest 200 obiektów i wywołujesz listę z wartością maxResults ustawioną na 20, lista zwróci pierwsze 20 obiektów i token. Wywołaj ponownie listę z wartością maxResults ustawioną na 20 i tokenem, aby uzyskać kolejne 20 obiektów.

max_results

int32

Określa maksymalną liczbę wyników zwracanych przez listę. Jeśli wartość maxResults nie jest zdefiniowana, zwracane są wszystkie wyniki.

TransitObjectListResponse

Pola
resources[]

TransitObject

Zasoby odpowiadające żądaniu listy.

pagination

Pagination

Podział odpowiedzi na strony.

TransitObjectPatchRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

resource

TransitObject

Treść żądania.

TransitObjectUpdateRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

resource

TransitObject

Treść żądania.