- リソース: TransitObject
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- PurchaseDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TicketCost
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TicketLeg
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TicketSeat
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- FareClass
- TripType
- ActivationStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 州名
- DeviceContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: TransitObject
JSON 表現 |
---|
{ "classReference": { object ( |
フィールド | |
---|---|
classReference |
親クラスの継承されたフィールドのコピー。これらのフィールドは GET 中に取得されます。 |
ticketNumber |
チケットの番号。交通事業者のシステムにおけるチケットの一意の識別子です。 |
passengerType |
乗客の人数。 |
passengerNames |
チケットが割り当てられている乗客の名前。上記の |
tripId |
この ID は、ユーザーが同じルートのチケットを複数保存した場合に、チケットをグループ化するために使用されます。 |
ticketStatus |
チケットのステータス。表示に影響する状態の場合は、代わりに |
customTicketStatus |
|
concessionCategory |
チケットの割引カテゴリ。 |
customConcessionCategory |
|
ticketRestrictions |
このチケットの使用制限に関する情報。たとえば、使用する必要がある曜日や許可されるルートなどを指定します。 |
purchaseDetails |
このチケットの購入の詳細。 |
ticketLeg |
1 つのチケット区間に、出発と到着の情報、搭乗および座席の情報が含まれている。複数の区間を指定する場合は、代わりに |
ticketLegs[] |
各チケットには 1 つ以上の区間を含めることができます。各区間には出発と到着の情報、搭乗および座席の情報が含まれています。片方区間のみを指定する場合は、代わりに |
hexBackgroundColor |
カードの背景色。設定されていない場合、ヒーロー画像の主要な色が使用され、ヒーロー画像が設定されていない場合は、ロゴの主要な色が使用されます。形式は #rrggbb です。ここで、rrggbb は 16 進数の RGB トリプレットです(例: |
tripType |
必須。この交通機関オブジェクトが表すルートのタイプ。出発地と目的地の間で使用するパスのタイトルや記号を決定するために使用されます。 |
id |
必須。オブジェクトの一意の識別子。この ID は、発行者のすべてのオブジェクトで一意である必要があります。この値は issuer ID の形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。一意の識別子には、英数字、「.」、「_」、「-」のみを使用してください。 |
classId |
必須。このオブジェクトに関連付けられているクラス。クラスはこのオブジェクトと同じ型で、すでに存在し、承認されている必要があります。 クラス ID は issuer ID の形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。 |
version |
非推奨 |
state |
必須。オブジェクトの状態。このフィールドは、アプリでのオブジェクトの表示方法を決定するために使用されます。たとえば、 |
barcode |
バーコードのタイプと値。 |
messages[] |
アプリに表示されるメッセージの配列。このオブジェクトのすべてのユーザーが、関連するメッセージを受け取ります。これらのフィールドの最大数は 10 です。 |
validTimeInterval |
このオブジェクトが |
locations[] |
注: 現在、このフィールドで位置情報通知をトリガーすることはサポートされていません。 |
hasUsers |
オブジェクトにユーザーが含まれているかどうかを示します。このフィールドはプラットフォームによって設定されます。 |
smartTapRedemptionValue |
このオブジェクトについて、NFC 経由でスマートタップ認定端末に送信される値。パスでスマートタップをサポートするには、クラスレベルのフィールド |
hasLinkedDevice |
このオブジェクトが現在 1 つのデバイスにリンクされているかどうか。このフィールドは、ユーザーがオブジェクトを保存し、デバイスにリンクするときにプラットフォームによって設定されます。一部のパートナーによる使用を想定しています。詳細についてはサポートにお問い合わせください。 |
disableExpirationNotification |
通知を明示的に抑制するかどうかを示します。このフィールドを true に設定した場合、 現在、これは特典に対してのみ設定できます。 |
infoModuleData |
非推奨です。代わりに textModulesData を使用してください。 |
imageModulesData[] |
画像モジュール データ。表示されるフィールドの最大数は、オブジェクト レベルでは 1 個、クラス オブジェクト レベルでは 1 個です。 |
textModulesData[] |
テキスト モジュールのデータ。テキスト モジュールのデータもクラスに定義されている場合は、両方が表示されます。表示されるフィールドの最大数は、オブジェクトから 10 個、クラスから 10 個です。 |
linksModuleData |
リンク モジュールのデータ。リンク モジュールのデータもクラスで定義されている場合は、両方が表示されます。 |
appLinkData |
アプリまたはウェブサイトへのリンク。パスの前面にボタンとして表示されるオプションです。AppLinkData が対応するクラスに提供されている場合は、オブジェクト AppLinkData のみが表示されます。 |
activationStatus |
オブジェクトの有効化ステータス。クラスに |
rotatingBarcode |
ローテーション バーコードのタイプと値。 |
deviceContext |
オブジェクトに関連付けられたデバイスのコンテキスト。 |
heroImage |
カードの前面に表示されるオプションのバナー画像。何も存在しない場合は、クラスのヒーロー画像が表示されます(存在する場合)。クラスのヒーロー画像も存在しない場合は、何も表示されません。 |
groupingInfo |
パスのグループ化に関する情報。 |
passConstraints |
オブジェクトの制約を渡します。NFC の動作の制限やスクリーンショットの動作などが含まれています。 |
saveRestrictions |
ユーザーがパスの保存を試みる前に確認する必要があるオブジェクトに関する制限。この制限は保存時にのみ適用されます。ユーザーがパスを保存した後に制限が変更された場合、すでに保存されているパスに新しい制限は適用されません。 |
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 |
使用できるルートに関する制限。たとえば、文字列「Reserved CrossCountry trains only」などです。 |
routeRestrictionsDetails |
上記の |
timeRestrictions |
このチケットの利用時間に関する制限。 |
otherRestrictions |
「ルート」に該当しないその他の規制「time」できます。 |
PurchaseDetails
JSON 表現 |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
フィールド | |
---|---|
purchaseReceiptNumber |
チケットの販売機関を通じてチケット購入を追跡するための領収書番号/ID。 |
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 |
この区間の運賃の簡単な説明/名前。例: 「いつでも 1 回限り」。 |
carriage |
乗客が乗車する必要がある列車または船の名前/番号。 |
platform |
乗客が車両に乗り込むためのプラットホームまたはゲート。 |
zone |
プラットホーム内の乗車エリア。 |
ticketSeat |
乗客の予約座席。複数の座席を指定する場合は、代わりに |
ticketSeats[] |
乗客の予約座席。座席を 1 つだけ指定する場合は、代わりに |
transitOperatorName |
このルートのこの区間を運行する交通事業者の名前。 |
transitTerminusName |
電車やバスなどの終着駅や行き先。 |
TicketSeat
JSON 表現 |
---|
{ "fareClass": enum ( |
フィールド | |
---|---|
fareClass |
指定席の運賃クラス。 |
customFareClass |
|
coach |
乗車券販売席がある車両の識別子。例: 「10」 |
seat |
チケット制座席の ID。例: 「42」。特定の ID がない場合は、代わりに |
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](未有効化)がデフォルトのステータスです。 |
not_activated |
|
ACTIVATED |
有効 |
activated |
|
DeviceContext
オブジェクトに関連付けられたデバイスのコンテキスト。
JSON 表現 |
---|
{ "deviceToken": string } |
フィールド | |
---|---|
deviceToken |
設定すると、クーポンに関する情報は、オブジェクトが有効になったときにのみ、対象のデバイスに返されます。ユーザーのデバイスをトレースするための不変の識別子としては使用しないでください。同じデバイスのパスが異なる場合や、同じデバイスのアクティベーションが異なる場合があります。これを設定する場合、呼び出し元は、アクティブにするオブジェクトに hasLinkedDevice も設定する必要があります。 |
メソッド |
|
---|---|
|
指定されたオブジェクト ID の交通機関オブジェクトにメッセージを追加します。 |
|
指定されたオブジェクト ID の交通機関オブジェクトを返します。 |
|
指定された ID とプロパティの交通機関オブジェクトを挿入します。 |
|
指定された発行者 ID のすべての交通機関オブジェクトのリストを返します。 |
|
指定されたオブジェクト ID の交通機関オブジェクトを更新します。 |
|
指定されたオブジェクト ID の交通機関オブジェクトを更新します。 |