REST Resource: transitobject

{
  "classReference": {
    object (TransitClass)
  },
  "ticketNumber": string,
  "passengerType": enum (PassengerType),
  "passengerNames": string,
  "tripId": string,
  "ticketStatus": enum (TicketStatus),
  "customTicketStatus": {
    object (LocalizedString)
  },
  "concessionCategory": enum (ConcessionCategory),
  "customConcessionCategory": {
    object (LocalizedString)
  },
  "ticketRestrictions": {
    object (TicketRestrictions)
  },
  "purchaseDetails": {
    object (PurchaseDetails)
  },
  "ticketLeg": {
    object (TicketLeg)
  },
  "ticketLegs": [
    {
      object (TicketLeg)
    }
  ],
  "hexBackgroundColor": string,
  "tripType": enum (TripType),
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "activationStatus": {
    object (ActivationStatus)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "deviceContext": {
    object (DeviceContext)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}

object (TransitClass)

父項類別的沿用欄位副本。這類欄位是在 GET 執行期間擷取。

string

票券的編號。這是大眾運輸公司系統中票券的專屬 ID。

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)

單段票券行程，含有出發和抵達的資訊，以及登機和座位資訊。如果要指定多段行程，請改用 ticketLegs 欄位。ticketLeg 和 ticketLegs 都可不設定。

object (TicketLeg)

每張票券可以包含一段以上的路段。每段行程都包含出發和抵達的資訊，以及登機和座位資訊。如果只指定一段行程，請改用 ticketLeg 欄位。ticketLeg 和 ticketLegs 都可不設定。

string

資訊卡的背景顏色。如未設定，則會使用主頁橫幅的主要顏色。如未設定主頁橫幅，則會使用標誌的主要顏色。格式為 #rrggbb，其中 rrggbb 是十六進位的 RGB 三元組，例如 #ffcc00。您也可以使用 RGB 三元組的簡寫版本 #rgb，例如 #fc0。

enum (TripType)

必要欄位。此大眾運輸物件代表的行程類型。用來判斷起點和目的地之間要使用的票證標題和/或符號。

string

必要欄位。物件的專屬 ID。特定核發者的所有物件 ID 都不得重複。這個值應依循 issuer ID 格式。identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。

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

這個物件目前是否已連結至單一裝置。當使用者儲存物件並將物件連結到裝置時，平台會設定這個欄位。適用於特定合作夥伴。詳情請洽詢支援團隊。

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)

在使用者嘗試儲存票證前，必須驗證的物件限制。請注意，這項限制只適用於節省時間。如果在儲存票證後變更限制，新的限制就不會套用至已儲存的票證。

{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}

object (LocalizedString)

可用路線的相關限制。例如「僅限預訂的 CrossCountry 列車班次」字串。

object (LocalizedString)

進一步瞭解上述 routeRestrictions。

object (LocalizedString)

這張票券的使用時間相關限制。

object (LocalizedString)

不屬於「路線」的其他限制或「時間」類別

{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}

string

透過售票機構追蹤購票情形的收據編號/ID。

string

票券的購買日期/時間。

日期/時間採用 ISO 8601 擴充格式 (包含或不含偏移值)。時間的精確度可以指定到奈秒。指定偏移值時可以使用秒精確度 (即使偏移秒數並非 ISO 8601 的一部分)。

例如：

1985-04-12T23:20:50.52Z 是世界標準時間 1985 年 4 月 12 日 23 時 20 分 50.52 秒。

1985-04-12T19:20:50.52-04:00 是世界標準時間 1985 年 4 月 12 日 19 時 20 分 50.52 秒，比世界標準時間慢 4 個小時 (與上述範例為同一時間)。如果活動是在紐約舉行，則等同於東部夏令時間 (EDT)。請注意，偏移量會因實施日光節約時間 (或夏令時間) 的地區而有差異，具體取決於一年之中的時間。

1985-04-12T19:20:50.52 是 1985 年 4 月 12 日 19 時 20 分 50.52 秒，不含偏移量資訊。

在沒有偏移量資訊的情況下，某些實用功能可能無法使用。

string

購票時使用的帳戶 ID。

string

購買的確認碼。多張不同票券可能會有相同的確認碼，且可使用這組驗證碼將票券分為一組。

object (TicketCost)

票券費用。

{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}

object (Money)

票券的面額。

object (Money)

票券的實際購買價格 (稅後和/或折扣後)。

object (LocalizedString)

說明所套用任何折扣的訊息。

{
  "originStationCode": string,
  "originName": {
    object (LocalizedString)
  },
  "destinationStationCode": string,
  "destinationName": {
    object (LocalizedString)
  },
  "departureDateTime": string,
  "arrivalDateTime": string,
  "fareName": {
    object (LocalizedString)
  },
  "carriage": string,
  "platform": string,
  "zone": string,
  "ticketSeat": {
    object (TicketSeat)
  },
  "ticketSeats": [
    {
      object (TicketSeat)
    }
  ],
  "transitOperatorName": {
    object (LocalizedString)
  },
  "transitTerminusName": {
    object (LocalizedString)
  }
}

string

出發站碼。如果 destinationStationCode 存在，或 originName 不存在，則此為必要項目。

object (LocalizedString)

出發站名稱。如果 desinationName 存在，或 originStationCode 不存在，則此為必要項目。

string

目的地站點代碼。

object (LocalizedString)

目的地名稱。

string

出發日期/時間。如果大眾運輸物件未設定有效的時間間隔，則此為必填屬性。

日期/時間採用 ISO 8601 擴充格式 (包含或不含偏移值)。時間的精確度可以指定到奈秒。指定偏移值時可以使用秒精確度 (即使偏移秒數並非 ISO 8601 的一部分)。

例如：

1985-04-12T23:20:50.52Z 是世界標準時間 1985 年 4 月 12 日 23 時 20 分 50.52 秒。

1985-04-12T19:20:50.52-04:00 是世界標準時間 1985 年 4 月 12 日 19 時 20 分 50.52 秒，比世界標準時間慢 4 個小時 (與上述範例為同一時間)。如果活動是在紐約舉行，則等同於東部夏令時間 (EDT)。請注意，偏移量會因實施日光節約時間 (或夏令時間) 的地區而有差異，具體取決於一年之中的時間。

1985-04-12T19:20:50.52 是 1985 年 4 月 12 日 19 時 20 分 50.52 秒，不含偏移量資訊。

不含偏移量的日期/時間部分會被視為「當地日期/時間」，且應是出發站的當地日期/時間。例如，如果出發站在 2018 年 6 月 5 日 20 時於出發站，則當地日期/時間的部分應為 2018-06-05T20:00:00。如果出發站點的當地日期/時間比世界標準時間慢 4 小時，可以加上 -04:00 的時差。

在沒有偏移量資訊的情況下，某些實用功能可能無法使用。

string

抵達日期/時間。

日期/時間採用 ISO 8601 擴充格式 (包含或不含偏移值)。時間的精確度可以指定到奈秒。指定偏移值時可以使用秒精確度 (即使偏移秒數並非 ISO 8601 的一部分)。

例如：

1985-04-12T23:20:50.52Z 是世界標準時間 1985 年 4 月 12 日 23 時 20 分 50.52 秒。

1985-04-12T19:20:50.52-04:00 是世界標準時間 1985 年 4 月 12 日 19 時 20 分 50.52 秒，比世界標準時間慢 4 個小時 (與上述範例為同一時間)。如果活動是在紐約舉行，則等同於東部夏令時間 (EDT)。請注意，偏移量會因實施日光節約時間 (或夏令時間) 的地區而有差異，具體取決於一年之中的時間。

1985-04-12T19:20:50.52 是 1985 年 4 月 12 日 19 時 20 分 50.52 秒，不含偏移量資訊。

不含偏移量的日期/時間部分會被視為「當地日期/時間」，且應是目的地站點的當地日期/時間。例如，如果活動在 2018 年 6 月 5 日 20 時於目的地站點發生，則當地日期/時間的部分應為 2018-06-05T20:00:00。如果目的地站點的當地日期/時間比世界標準時間慢 4 小時，可以加上 -04:00 的時差。

在沒有偏移量資訊的情況下，某些實用功能可能無法使用。

object (LocalizedString)

這個行程的票價簡短說明/名稱。例如「任何時間單次使用」。

string

乘客要搭乘的火車或船舶名稱/編號。

string

乘客乘車的月台或閘門。

string

月台中的乘車區域。

object (TicketSeat)

乘客的預留座位。如果要指定多個座位，請改用 ticketSeats 欄位。ticketSeat 和 ticketSeats 都可不設定。

object (TicketSeat)

乘客的預留座位。如果僅指定一個座位，請改用 ticketSeat 欄位。ticketSeat 和 ticketSeats 都可不設定。

object (LocalizedString)

負責營運此行程路段的大眾運輸業者名稱。

object (LocalizedString)

火車/公車等的終點站或目的地。

{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}

enum (FareClass)

售票座位的艙等。

object (LocalizedString)

未套用 fareClass 時採用的自訂車資類別。fareClass 和 customFareClass 都可不設定。

string

售票座位所在的車廂 ID，例如：「10」

string

售票座位所在位置的 ID，例如：「42」。如果沒有專屬 ID，請改用 seatAssigment。

object (LocalizedString)

乘客的座位安排。例如：「無特定座位」。使用時機為 seat 中沒有特定 ID 可用時。

{
  "state": enum (State)
}

enum (State)

{
  "deviceToken": string
}

string

如果設定這個項目，兌換資訊只會在啟用物件後傳回給指定裝置。這個 ID 不得做為追蹤使用者裝置的穩定 ID。可能會因在同一部裝置的不同票證上，甚至是同一部裝置的不同啟用方式間變更。啟用這項設定後，呼叫端也必須在所啟用的物件中設定 hasLinkedDevice。