資源:EventTicketClass
JSON 表示法 |
---|
{ "kind": string, "eventName": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
eventName |
必要欄位。活動名稱,例如「洛杉磯道奇隊在舊金山巨人隊主場比賽」。 |
eventId |
活動的 ID。帳戶中每個事件的 ID 都不得重複。如果使用者儲存了同一活動的多張票券,系統會使用這項資訊將票券分組。長度上限為 64 個半形字元。 如果提供此屬性,分組作業將可穩定進行。請留意意外發生的衝突,避免將不應屬於同一組的票券分為一組。如果每項活動僅有一個類別,您可以直接將這個屬性設為 如果未提供這個屬性,平台將會嘗試使用其他資料為票券分組 (可能不穩定)。 |
logo |
票券的標誌圖片。這張圖片會顯示在應用程式的卡片資料檢視畫面中。 |
venue |
活動地點詳細資料。 |
dateTime |
事件的日期和時間資訊。 |
confirmationCodeLabel |
要在卡片詳細資料檢視畫面上用於確認碼值 (
|
customConfirmationCodeLabel |
用於卡片詳細資料檢視畫面上確認碼值 (
|
seatLabel |
要在卡片詳細資料檢視畫面上針對座位值 (
|
customSeatLabel |
要在卡片詳細資料檢視畫面上針對座位值 (
|
rowLabel |
要在卡片詳細資料檢視畫面上針對排值 (
|
customRowLabel |
要在卡片詳細資料檢視畫面上針對排值 (
|
sectionLabel |
要在卡片詳細資料檢視畫面上針對區域值 (
|
customSectionLabel |
要在卡片詳細資料檢視畫面上針對區域值 (
|
gateLabel |
要在卡片詳細資料檢視畫面上針對閘門值 (
|
customGateLabel |
要在卡片詳細資料檢視畫面上針對閘門值 (
|
finePrint |
票券的附屬細則、條款或條件。 |
classTemplateInfo |
類別顯示方式的範本資訊。如未設定,Google 會改回顯示一組預設欄位。 |
id |
必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應採用以下格式:issuer ID。identifier,其中前者是由 Google 核發,後者則您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
version |
已淘汰 |
issuerName |
必要欄位。核發者的名稱。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限為 10 個。 |
allowMultipleUsersPerObject |
已淘汰,請改用 |
homepageUri |
應用程式首頁的 URI。在這個欄位填入 URI 會產生與在 linksModuleData 填入 URI 相同的行為 (轉譯物件時,首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。 |
locations[] |
注意:這個欄位目前不支援觸發地理通知。 |
reviewStatus |
必要欄位。類別的狀態。可以透過 insert、patch 或更新 API 呼叫,將此欄位設為 當類別處於開發階段時,這個欄位應保留為 如果您確認類別可供使用,應將這個欄位設為 更新已處於 |
review |
當類別標示為 |
infoModuleData |
已淘汰,請改用 textModulesData。 |
imageModulesData[] |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
textModulesData[] |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為物件中的 10 個,以及類別中的 10 個。 |
linksModuleData |
連結模組資料。如果物件中也定義了連結模組資料,則兩項資料都會顯示。 |
redemptionIssuers[] |
找出哪些兌換核發機構可以透過智慧感應功能兌換票證。兌換核發機構由其核發機構 ID 識別。兌換核發機構必須設定至少一個智慧感應功能。 此外,您也必須正確設定 |
countryCode |
國家/地區代碼,用於顯示卡片的國家/地區 (當使用者不在該國家/地區時),以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。 |
heroImage |
顯示在資訊卡正面的選用橫幅圖片。如果沒有顯示任何項目,系統就不會顯示任何內容。圖片寬度為 100%。 |
wordMark |
已淘汰。 |
enableSmartTap |
指出這個類別是否支援智慧感應功能。此外,您也必須正確設定 |
hexBackgroundColor |
資訊卡的背景顏色。如果未設定,將會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,則會使用標誌的主要顏色。格式為 #rrggbb,其中 rrggbb 是十六進位的 RGB 三元組,例如 |
localizedIssuerName |
cardName 的翻譯字串。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
multipleDevicesAndHoldersAllowedStatus |
指出是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。 |
callbackOptions |
使用者每次儲存/刪除這個類別的物件時,都可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼。 |
securityAnimation |
關於安全性動畫的選擇性資訊。如果設定了這項政策,票證詳細資料就會顯示安全性動畫。 |
viewUnlockRequirement |
查看活動票券的解鎖要求選項。 |
wideLogo |
票券的寬標誌。提供此設定會用來取代資訊卡檢視左上方的標誌。 |
appLinkData |
選用的應用程式或網站連結,會顯示在票證正面的按鈕中。如果你已為相應的物件提供 AppLinkData,系統將改用對應的物件。 |
EventVenue
JSON 表示法 |
---|
{ "kind": string, "name": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
name |
活動場所名稱,例如「AT&T 公園」。 此為必要資訊。 |
address |
活動場館的地址,例如「24 Willie Mays Plaza\nSan Francisco, CA 94107」。地址以換行字元 ( 此為必要資訊。 |
EventDateTime
JSON 表示法 |
---|
{ "kind": string, "doorsOpen": string, "start": string, "end": string, "doorsOpenLabel": enum ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
doorsOpen |
活動場門開始的日期與時間。 日期/時間採用 ISO 8601 擴充格式 (無論是否含有偏移量)。時間的精確度可以指定到奈秒。偏移量可以指定秒精確度 (雖然偏移秒數並非 ISO 8601 的一部分)。 例如:
不含偏移量的日期/時間部分會視為「當地日期/時間」,且應是活動地點的當地日期/時間。舉例來說,如果活動在 2018 年 6 月 5 日 20 時於活動地點舉辦,則當地日期/時間的部分應為 在沒有偏移資訊的情況下,某些實用功能可能無法使用。 |
start |
活動開始的日期/時間。如果活動橫跨數天,則應為第一天的開始日期/時間。 日期/時間採用 ISO 8601 擴充格式 (無論是否含有偏移量)。時間的精確度可以指定到奈秒。偏移量可以指定秒精確度 (雖然偏移秒數並非 ISO 8601 的一部分)。 例如:
不含偏移量的日期/時間部分會視為「當地日期/時間」,且應是活動地點的當地日期/時間。舉例來說,如果活動在 2018 年 6 月 5 日 20 時於活動地點舉辦,則當地日期/時間的部分應為 在沒有偏移資訊的情況下,某些實用功能可能無法使用。 |
end |
活動結束的日期/時間。如果活動橫跨數天,則應為活動最後一天的結束日期/時間。 日期/時間採用 ISO 8601 擴充格式 (無論是否含有偏移量)。時間的精確度可以指定到奈秒。偏移量可以指定秒精確度 (雖然偏移秒數並非 ISO 8601 的一部分)。 例如:
不含偏移量的日期/時間部分會視為「當地日期/時間」,且應是活動地點的當地日期/時間。舉例來說,如果活動在 2018 年 6 月 5 日 20 時於活動地點舉辦,則當地日期/時間的部分應為 在沒有偏移資訊的情況下,某些實用功能可能無法使用。 |
doorsOpenLabel |
要在卡片詳細資料檢視畫面上針對開放進場時間值 (
|
customDoorsOpenLabel |
卡片詳細資料檢視畫面上用於開放進場時間值 (
|
DoorsOpenLabel
列舉 | |
---|---|
DOORS_OPEN_LABEL_UNSPECIFIED |
|
DOORS_OPEN |
|
doorsOpen |
|
GATES_OPEN |
|
gatesOpen |
|
ConfirmationCodeLabel
列舉 | |
---|---|
CONFIRMATION_CODE_LABEL_UNSPECIFIED |
|
CONFIRMATION_CODE |
|
confirmationCode |
|
CONFIRMATION_NUMBER |
|
confirmationNumber |
|
ORDER_NUMBER |
|
orderNumber |
|
RESERVATION_NUMBER |
|
reservationNumber |
|
SeatLabel
列舉 | |
---|---|
SEAT_LABEL_UNSPECIFIED |
|
SEAT |
|
seat |
|
RowLabel
列舉 | |
---|---|
ROW_LABEL_UNSPECIFIED |
|
ROW |
|
row |
|
SectionLabel
列舉 | |
---|---|
SECTION_LABEL_UNSPECIFIED |
|
SECTION |
|
section |
|
THEATER |
|
theater |
|
GateLabel
列舉 | |
---|---|
GATE_LABEL_UNSPECIFIED |
|
GATE |
|
gate |
|
DOOR |
|
door |
|
ENTRANCE |
|
entrance |
|
方法 |
|
---|---|
|
新增訊息至指定類別 ID 參照的活動票券類別。 |
|
傳回具有指定類別 ID 的活動票券類別。 |
|
插入具有指定 ID 和屬性的活動票券類別。 |
|
傳回指定核發者 ID 的所有活動票券類別清單。 |
|
更新指定類別 ID 參照的活動票券類別。 |
|
更新指定類別 ID 參照的活動票券類別。 |