REST Resource: eventticketobject

{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "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)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}

string

標示資源的種類。值：固定字串 "walletobjects#eventTicketObject"。

object (EventTicketClass)

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

object (EventSeat)

這張票券的座位詳細資料。

object (EventReservationInfo)

這張票券的預訂詳細資料。這個值預計由在同一訂單購買的所有票券中共用。

string

票券持有人的姓名 (如果票券已指派給某人)。例如：「王志明」或「王小珍」。

string

票券的編號。這可以是發卡機構系統中的所有票券專屬 ID、活動的所有票券 (例如 XYZ1234512345) 或訂單中的所有票券 (1、2、3 等)。

object (LocalizedString)

票券的類型，例如「成人」或「貴子」或「VIP」或「標準」

object (Money)

票券的面額，必須與實體票券上所列的金額相符。

object (GroupingInfo)

控管票證分組方式的資訊。

string

與此活動票券連結的優惠物件清單。優惠物件必須已存在。

優惠物件 ID 應採用下列格式：issuer ID。identifier 的格式，其中前者是由 Google 核發，後者則由您指定。

string

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

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 (RotatingBarcode)

旋轉的條碼類型和值。

object (Image)

顯示在資訊卡正面的選用橫幅圖片。如果沒有，則會顯示類別的主頁橫幅 (如有)。如果該類別的主頁橫幅也未顯示，系統就不會顯示任何內容。

object (PassConstraints)

傳遞物件的限制條件。包括限制 NFC 和螢幕截圖使用行為。

object (SaveRestrictions)

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

{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}

string

標示資源的種類。值：固定字串 "walletobjects#eventSeat"。

object (LocalizedString)

座位號碼，例如「1」、「2」、「3」或任何其他座位 ID。

這個欄位可本地化，因此您可以翻譯字詞，或將 ID 中的字元使用不同的字母。

object (LocalizedString)

座位的排數，例如「1」、「E」、「BB」或「A5」。

這個欄位可本地化，因此您可以翻譯字詞，或將 ID 中的字元使用不同的字母。

object (LocalizedString)

座位的分區，例如「121」。

這個欄位可本地化，因此您可以翻譯字詞，或將 ID 中的字元使用不同的字母。

object (LocalizedString)

票券持有人前往座位時應進入的閘門，例如「A」或「西部」。

這個欄位可本地化，因此您可以翻譯字詞，或將 ID 中的字元使用不同的字母。

{
  "kind": string,
  "confirmationCode": string
}

string

標示資源的種類。值：固定字串 "walletobjects#eventReservationInfo"。

string

活動預訂的確認碼。這個值也可以採用「訂單號碼」、「確認編號」、「預訂編號」或其他同等項目的形式。