REST Resource: transitobject

object (TransitClass)

親クラスの継承されたフィールドのコピー。このフィールドは、GET 中に取得されます。

string

チケットの番号。これは、交通事業者のシステムでのチケットの一意の識別子です。

enum (PassengerType)

乗客の人数。

string

チケットが割り当てられている乗客の名前。上記の passengerType フィールドは、このフィールドに関するコンテキストを Google に提供するためのものです。

string

この ID は、ユーザーが同じ旅行のチケットを複数保存している場合に、チケットをグループ化するために使用されます。

enum (TicketStatus)

チケットのステータス。表示に影響する状態については、代わりに state フィールドを使用します。

object (LocalizedString)

ticketStatus に適切なオプションがない場合に、チケットのステータス値に使用するカスタム ステータス。ticketStatus と customTicketStatus の両方は設定できません。

enum (ConcessionCategory)

チケットの割引カテゴリ。

object (LocalizedString)

concessionCategory に適切なオプションがない場合に使用するカスタム割引カテゴリ。concessionCategory と customConcessionCategory の両方は設定できません。

object (TicketRestrictions)

このチケットの使用制限に関する情報。たとえば、どの曜日に使用する必要があるかや、どのルートを使用できるかなどです。

object (PurchaseDetails)

このチケットの購入の詳細。

object (TicketLeg)

1 つのチケット区間には、出発と到着の情報、搭乗および座席の情報が含まれています。複数の区間を指定する場合は、代わりに ticketLegs フィールドを使用します。ticketLeg と ticketLegs の両方は設定できません。

object (TicketLeg)

各チケットに 1 つ以上の区間が含まれています。各区間には出発と到着の情報、搭乗および座席の情報が含まれています。1 つの区間のみを指定する場合は、代わりに ticketLeg 項目を使用します。ticketLeg と ticketLegs の両方は設定できません。

string

カードの背景色。設定されていない場合は、ヒーロー画像の主要色が使用され、ヒーロー画像が設定されていない場合は、ロゴの主要色が使用されます。形式は #rrggbb です。ここで、rrggbb は 16 進数の RGB トリプレットです（例: #ffcc00）。#fc0 など、RGB トリプレットの省略形も使用できます。rgb

enum (TripType)

必須。この交通機関オブジェクトが表すルートのタイプ。出発地と目的地の間で使用するパスのタイトルやシンボルを決定するために使用されます。

string

必須。オブジェクトの一意識別子。この ID は、発行者のすべてのオブジェクトに対して、一意である必要があります。この値には issuer ID.identifier の形式にする必要があります。前の部分は Google が発行するものであり、後の部分はご自身で選択するものです。一意識別子には、英数字、「.」、「_」、「-」のみを使用できます。

string

必須。このオブジェクトに関連付けられているクラス。クラスはこのオブジェクトと同じ型で、すでに存在し、承認される必要があります。

クラス ID は issuer ID の形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。

string (int64 format)

非推奨

enum (State)

必須。オブジェクトの状態。このフィールドは、アプリでのオブジェクトの表示方法を決定するために使用されます。たとえば、inactive オブジェクトを「期限切れのパス」セクションに移動する場合に使用します。

object (Barcode)

バーコードのタイプと値。

object (Message)

アプリに表示されるメッセージの配列。このオブジェクトのすべてのユーザーが、関連するメッセージを受け取ります。これらのフィールドの最大数は 10 です。

object (TimeInterval)

このオブジェクトが active になり、オブジェクトが使用可能になる期間。この期間が経過すると、オブジェクトの状態は expired に変更されます。

object (LatLongPoint)

注: 現在、このフィールドはジオフェンス通知のトリガーには対応していません。

boolean

オブジェクトにユーザーが存在するかどうかを示します。このフィールドはプラットフォームによって設定されます。

string

このオブジェクトについて、NFC を介してスマートタップ認定端末に送信される値。パスがスマートタップをサポートするには、クラスレベルのフィールド enableSmartTap と redemptionIssuers も正しく設定する必要があります。サポートされているのは ASCII 文字のみです。

boolean

このオブジェクトが現在 1 つのデバイスにリンクされているかどうか。このフィールドは、ユーザーがオブジェクトを保存し、デバイスにリンクするときに、プラットフォームによって設定されます。一部のパートナーが使用することを想定しています。詳細についてはサポートにお問い合わせください。

boolean

通知を明示的に止めるかどうかを示します。このフィールドを true に設定した場合、messages フィールドに関係なく、ユーザーへの有効期限通知が抑制されます。デフォルトでは、このフィールドは false に設定されています。

現在、これは特典に対してのみ設定できます。

object (InfoModuleData)

非推奨です。代わりに textModulesData を使用してください。

object (ImageModuleData)

画像モジュール データ。表示されるフィールドの最大数は、オブジェクト レベルでは 1 個、クラス オブジェクト レベルでは 1 個です。

object (TextModuleData)

テキスト モジュールのデータ。テキスト モジュールのデータがクラスにも定義されている場合、両方が表示されます。このフィールドが表示される数には上限があり、オブジェクトから 10 個、クラスから 10 個が最大数になります。

object (LinksModuleData)

リンク モジュールのデータ。リンク モジュールのデータがクラスにも定義されている場合、両方が表示されます。

object (AppLinkData)

パスの表面にボタンとして表示される、アプリまたはウェブサイトのリンク（省略可）。AppLinkData が対応するクラスに提供されている場合は、オブジェクト AppLinkData のみが表示されます。

object (ActivationStatus)

オブジェクトの有効化ステータス。クラスに activationOptions が設定されている場合は必須です。

object (RotatingBarcode)

回転バーコードのタイプと値。

object (DeviceContext)

オブジェクトに関連付けられたデバイス コンテキスト。

object (Image)

カードの表面に表示されるオプションのバナー画像。何も存在しない場合は、クラスのヒーロー画像が表示されます（存在する場合）。クラスのヒーロー画像も存在しない場合は、何も表示されません。

object (GroupingInfo)

パスのグループ化に関する情報。

object (PassConstraints)

オブジェクトの制約を渡します。NFC とスクリーンショットの動作の制限が含まれます。

object (SaveRestrictions)

ユーザーがパスを保存しようとする前に確認が必要なオブジェクトの制限。この制限は保存時にのみ適用されます。ユーザーがパスを保存した後に制限が変更された場合、すでに保存されているパスには新しい制限は適用されません。

string

linkObjectIds は、この交通機関オブジェクトに自動的に付加されるオブジェクト（イベント チケット、ポイント、クーポン、汎用、ギフトカード、交通機関、搭乗券など）のリストです。ユーザーがこの交通機関のカードを保存していた場合、これらの linkObjectIds は自動的にユーザーのウォレットにプッシュされます（ユーザーがこのようなリンクされたパスを受け取る設定を無効にした場合を除く）。

linkedObjectIds に存在するオブジェクトがすでに挿入されていることを確認します。挿入されていない場合、呼び出しは失敗します。リンクしたオブジェクトのリンクは解除できません。別の発行者に属するオブジェクトはリンクできません。1 つのオブジェクトにリンクできるオブジェクトの数には上限があります。上限に達すると、呼び出し内の新しくリンクされたオブジェクトは通知なく無視されます。

オブジェクト ID は issuer ID 形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。

enum (NotificationSettingsForUpdates)

このオブジェクトのフィールドの更新を通知のトリガーにするかどうか。NOTIFY に設定すると、フィールドの更新通知がユーザーに送信されます。これらの通知は、フィールドが許可リストに含まれている場合にのみユーザーに送信されます。DO_NOT_NOTIFY または NOTIFICATION_SETTINGS_UNSPECIFIED に設定した場合、通知はトリガーされません。この設定は一時的な設定であり、PATCH リクエストまたは UPDATE リクエストごとに設定する必要があります。設定しない場合、通知はトリガーされません。

object (ValueAddedModuleData)

オプションの付加価値モジュール データ。オブジェクトに最大 10 個。

object (LocalizedString)

使用できるルートに関する制限。たとえば、これは「予約済みの CrossCountry 社の列車のみ」という文字列です。

object (LocalizedString)

上記の routeRestrictions の詳細。

object (LocalizedString)

このチケットを使用できる時間に関する制限。

object (LocalizedString)

「ルート」または「時間」カテゴリに該当しないその他の制限。

string

チケットの販売機関を通じてチケット購入を追跡するための領収書番号/ID。

string

チケットの購入日時。

これは、ISO 8601 拡張形式の日付 / 時刻です。オフセットを指定することもできます。時刻は、ナノ秒の精度まで指定できます。オフセットは秒の精度で指定できます（オフセット秒は ISO 8601 には含まれていません）。

例:

1985-04-12T23:20:50.52Z は UTC で 1985 年 4 月 12 日の 23 時 20 分 50.52 秒になります。

1985-04-12T19:20:50.52-04:00 は、1985 年 4 月 12 日の 19 時から 20 分 50.52 秒、つまり UTC の 4 時間前（上記の例と同じ時刻）になります。このイベントがニューヨークで開催されていた場合、これはアメリカ東部夏時間（EDT）に相当します。夏時間（またはサマータイム）が適用される地域では、時期によってオフセットが異なることに注意してください。

1985-04-12T19:20:50.52 は 1985 年 4 月 12 日の 19 時 20 分 50.52 秒で、オフセット情報はありません。

オフセット情報がないと、一部のリッチ機能を使用できない場合があります。

string

チケットの購入に使用されたアカウントの ID。

string

購入の確認コード。これは複数の異なるチケットで同じ場合があり、チケットをグループ化するために使用されます。

object (TicketCost)

チケットの費用。

object (Money)

チケットの額面金額。

object (Money)

税や割引後のチケットの実際の購入価格。

object (LocalizedString)

適用された割引について説明するメッセージ。

string

交通機関の出発地のコード。これは、destinationStationCode が存在する場合、または originName が存在しない場合に必要です。

object (LocalizedString)

出発地のステーションの名前。desinationName が存在する場合、または originStationCode が存在しない場合は必須です。

string

交通機関の目的地のコード。

object (LocalizedString)

目的地の名前。

string

出発の日付 / 時刻。これは、交通機関オブジェクトに有効期間が設定されていない場合に必要です。

これは、ISO 8601 拡張形式の日付 / 時刻です。オフセットを指定することもできます。時刻はナノ秒の精度で指定できます。オフセットは秒の精度で指定できます（オフセット秒は ISO 8601 には含まれていません）。

例:

1985-04-12T23:20:50.52Z は UTC で 1985 年 4 月 12 日の 23 時 20 分 50.52 秒になります。

1985-04-12T19:20:50.52-04:00 は、1985 年 4 月 12 日の 19 時から 20 分 50.52 秒、つまり UTC の 4 時間前（上記の例と同じ時刻）になります。このイベントがニューヨークで開催されていた場合、これはアメリカ東部夏時間（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 を追加できます。

オフセット情報がないと、一部のリッチ機能を使用できない場合があります。

string

到着日時。

これは ISO 8601 拡張形式の日付/時刻で、オフセットあり、またはオフセットなしです。時刻は、ナノ秒の精度まで指定できます。オフセットは秒の精度で指定できます（オフセット秒は ISO 8601 には含まれていません）。

例:

1985-04-12T23:20:50.52Z は UTC で 1985 年 4 月 12 日の 23 時 20 分 50.52 秒になります。

1985-04-12T19:20:50.52-04:00 は、1985 年 4 月 12 日の 19 時から 20 分 50.52 秒、つまり UTC の 4 時間前（上記の例と同じ時刻）になります。このイベントがニューヨークで開催されていた場合、これはアメリカ東部夏時間（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 のオフセットを追加できます。

オフセット情報がない場合、高度な機能の一部を使用できないことがあります。

object (LocalizedString)

この区間の運賃の簡単な説明/名前。例: 「いつでも 1 回限り」。

string

乗客が乗る必要がある列車または船の名前 / 番号。

string

乗客が乗るために使用するプラットホームまたはゲート。

string

プラットホーム内の乗車位置。

object (TicketSeat)

乗客の指定席。複数の座席を指定する場合は、代わりに ticketSeats 項目を使用します。ticketSeat と ticketSeats の両方は設定できません。

object (TicketSeat)

乗客の予約座席。座席を 1 つのみ指定する場合は、代わりに ticketSeat 項目を使用します。ticketSeat と ticketSeats の両方は設定できません。

object (LocalizedString)

この旅行区間を運行している交通事業者の名前。

object (LocalizedString)

列車 / バスなどの終点または目的地。

enum (FareClass)

指定席の運賃クラス。

object (LocalizedString)

fareClass が適用されないときに使用されるカスタム運賃クラス。fareClass と customFareClass の両方は設定できません。

string

乗車券販売席がある車両の識別子。例: 「10」

string

指定された座席がある場所の識別子。例: 「42」。特定の ID がない場合は、代わりに seatAssigment を使用します。

object (LocalizedString)

乗客の席の割り当て。例: 「特定の座席なし」。seat で使用する特定の識別子がない場合に使用します。

enum (State)

string

設定すると、オブジェクトが有効になったときに、クーポン情報が所定のデバイスにのみ返されます。ユーザーのデバイスをトレースするための不変の識別子としては使用しないでください。デバイスが同じでもパスが異なる場合や、デバイスが同じでも有効化が異なる場合は、設定が変わることがあります。これを設定する場合、呼び出し元は、アクティブにするオブジェクトに hasLinkedDevice も設定する必要があります。