REST Resource: eventticketclass

{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  }
}

string

指出資源的類型。值：固定字串 "walletobjects#eventTicketClass"。

object (LocalizedString)

必要欄位。活動名稱，例如「洛杉磯道奇隊在舊金山巨人隊主場」

string

事件的 ID。帳戶中每一個事件的 ID 都不得重複。如果使用者針對同一個活動儲存多張票券，系統會使用這項資訊將票券分組。長度上限為 64 個半形字元。

如果提供這項資訊，群組就能穩定執行。請小心意外發生的衝突，避免將不應屬於同一組的票券分為一組。如果每項活動僅有一個類別，您可以直接將這個屬性設為 classId (無論是否包含核發者 ID 部分)。

如未提供這項資訊，平台會嘗試使用其他資料為票券分組 (可能不穩定)。

object (Image)

票券的標誌圖片。這張圖片會顯示在應用程式的卡片詳細資料檢視畫面中。

object (EventVenue)

活動地點詳細資料。

object (EventDateTime)

活動的日期和時間資訊。

enum (ConfirmationCodeLabel)

要在卡片詳細資料檢視畫面中針對確認碼值 (eventTicketObject.reservationInfo.confirmationCode) 使用的標籤。每個可用的選項會對應至一組本地化字串，以便根據使用者的語言代碼顯示翻譯。

confirmationCodeLabel 和 customConfirmationCodeLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「確認代碼」。如果未設定確認碼欄位，就不會使用這個標籤。

object (LocalizedString)

要在卡片詳細資料檢視畫面中用於確認碼值 (eventTicketObject.reservationInfo.confirmationCode) 的自訂標籤。只有預設的「確認碼」標籤或其中一個 confirmationCodeLabel 選項不敷使用時，才應使用這個屬性。

confirmationCodeLabel 和 customConfirmationCodeLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「確認代碼」。如果未設定確認碼欄位，就不會使用這個標籤。

enum (SeatLabel)

要在卡片詳細資料檢視畫面上針對座位值 (eventTicketObject.seatInfo.seat) 使用的標籤。每個可用的選項會對應至一組本地化字串，以便根據使用者的語言代碼顯示翻譯。

seatLabel 和 customSeatLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「座位」。如未設定座位欄位，就不會使用這個標籤。

object (LocalizedString)

要在卡片詳細資料檢視畫面上針對座位值 (eventTicketObject.seatInfo.seat) 使用的自訂標籤。只有預設的「座位」標籤或其中一個 seatLabel 選項不敷使用時，才應使用這個屬性。

seatLabel 和 customSeatLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「座位」。如未設定座位欄位，就不會使用這個標籤。

enum (RowLabel)

要在卡片詳細資料檢視畫面上針對資料列值 (eventTicketObject.seatInfo.row) 使用的標籤。每個可用的選項會對應至一組本地化字串，以便根據使用者的語言代碼顯示翻譯。

rowLabel 和 customRowLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「列」。如果未設定排數欄位，就不會使用這個標籤。

object (LocalizedString)

要在卡片詳細資料檢視畫面上針對資料列值 (eventTicketObject.seatInfo.row) 使用的自訂標籤。只有預設的「列」標籤或其中一個 rowLabel 選項不敷使用時，才應使用這個屬性。

rowLabel 和 customRowLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「列」。如果未設定排數欄位，就不會使用這個標籤。

enum (SectionLabel)

要在卡片詳細資料檢視畫面中針對區域值 (eventTicketObject.seatInfo.section) 使用的標籤。每個可用的選項會對應至一組本地化字串，以便根據使用者的語言代碼顯示翻譯。

sectionLabel 和 customSectionLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「區」。如果未設定區段欄位，就不會使用這個標籤。

object (LocalizedString)

要在卡片詳細資料檢視畫面中針對區域值 (eventTicketObject.seatInfo.section) 使用的自訂標籤。只有預設的「區」標籤或其中一個 sectionLabel 選項不敷使用時，才應使用這個屬性。

sectionLabel 和 customSectionLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「區」。如果未設定區段欄位，就不會使用這個標籤。

enum (GateLabel)

卡片詳細資料檢視畫面中閘門值 (eventTicketObject.seatInfo.gate) 的標籤。每個可用的選項會對應至一組本地化字串，以便根據使用者的語言代碼顯示翻譯。

gateLabel 和 customGateLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「閘門」。如未設定閘門欄位，就不會使用這個標籤。

object (LocalizedString)

要在卡片詳細資料檢視畫面上針對閘門值 (eventTicketObject.seatInfo.gate) 使用的自訂標籤。只有預設的「閘門」標籤或其中一個 gateLabel 選項不敷使用時，才應使用這個屬性。

gateLabel 和 customGateLabel 不予設定。如果這二者皆未設定，標籤將預設為已經過本地化的「閘門」。如未設定閘門欄位，就不會使用這個標籤。

object (LocalizedString)

票券的附屬細則、條款或條件。

object (ClassTemplateInfo)

類別顯示方式的範本資訊。如未設定，Google 會改回顯示一組預設欄位。

string

必要欄位。類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應採用下列格式：issuer ID。identifier，其中前者是由 Google 核發，後者則是由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。

string (int64 format)

已淘汰

string

必要欄位。核發者名稱。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。

object (Message)

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到相關聯的訊息。這類欄位的數量上限是 10 個。

boolean

已淘汰，請改用 multipleDevicesAndHoldersAllowedStatus。

object (Uri)

應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (轉譯物件時，首頁連結會顯示在通常視為物件的 linksModuleData 區段) 中。

object (LatLongPoint)

注意：這個欄位目前不支援觸發地理區域通知。

enum (ReviewStatus)

必要欄位。類別的狀態。可以透過插入、修補或更新 API 呼叫的方式，將這個欄位設為 draft 或 underReview。一旦審查狀態從 draft 變更為其他狀態，就無法再變回 draft。

如果類別還在開發階段，則應將這個欄位保留為 draft。draft 類別無法用於建立任何物件。

如果您確認類別可供使用，請將這個欄位設為 underReview。平台會自動將這個欄位設為 approved，這樣就能立即用來建立或遷移物件。

更新現有的 approved 類別時，請繼續將這個欄位設為 underReview。

object (Review)

當類別標示為 approved 或 rejected 時，平台所設定的評論留言。

object (InfoModuleData)

已淘汰，請改用 textModulesData。

object (ImageModuleData)

圖片模組資料。這類欄位顯示數量上限為物件層級 1 個，類別物件層級則為 1 個。

object (TextModuleData)

文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個，以及來自類別的 10 個。

object (LinksModuleData)

連結模組資料。如果物件中也定義了連結模組資料，則兩項資料都會顯示。

string (int64 format)

找出哪些兌換核發機構可透過智慧感應功能兌換票證。兌換核發機構是依核發機構 ID 進行識別。兌換核發機構至少須設定一個智慧感應功能金鑰。

請務必正確設定 enableSmartTap 和物件層級的 smartTapRedemptionLevel 欄位，才能讓票證支援智慧感應功能。

string

國家/地區代碼，用於顯示卡片所在的國家/地區 (當使用者不在該國家/地區時)，以及當沒有使用者語言代碼中的內容時，改為顯示本地化內容。

object (Image)

顯示在卡片正面的選用橫幅圖片。如果沒有顯示，就不會顯示任何內容。圖片會以 100% 寬度顯示。

object (Image)

已淘汰。

boolean

指出這個類別是否支援智慧感應功能。請務必正確設定 redemptionIssuers 和物件層級的 smartTapRedemptionLevel 欄位，才能讓票證支援智慧感應功能。

string

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

object (LocalizedString)

providerName 的翻譯字串。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。

enum (MultipleDevicesAndHoldersAllowedStatus)

表示多位使用者和裝置是否會儲存參照這個類別的相同物件。

object (CallbackOptions)

每當使用者儲存/刪除這個類別的物件時，可以使用這些回呼選項來呼叫發卡機構。這個類別的所有物件都有資格使用回呼。

object (SecurityAnimation)

安全性動畫的選用資訊。如果設定這個屬性，系統會在票證詳細資料中顯示安全性動畫。

enum (ViewUnlockRequirement)

查看活動票券的解鎖規定選項。

object (Image)

票券的寬標誌。如有提供，這將會取代卡片檢視畫面左上方的標誌。