本頁面說明類別和物件之間的關係,這是 Google Pay API for Passes 的運作基礎。本文也會說明物件與使用者之間的連結方式。
類別和物件
Google Pay API for Passes 是以「物件」這種數位化的概念來代表實體的會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證;API 則運用「類別」的概念,讓您管理所有使用者之間的共通資料。為了涵蓋特定用途,每種票證都有專屬的物件和類別。
舉例來說,使用者在 Google Pay 應用程式中擁有的每張會員卡都會以一個 LoyaltyObject
表示,其會參照 LoyaltyClass
。同樣地,使用者在 Google Pay 應用程式中擁有的每張儲值卡都會以 GiftCardObject
表示,其會參照 GiftCardClass
。
每個物件都會參照類別,方便您將變更套用至所有會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證。
類別含有物件的共通資料。舉例來說,LoyaltyClass
會儲存 programName
,而 LoyaltyObject
則會儲存個別使用者的 accountId
。類別與物件之間可能是一對一的關係,但並非一律如此,多個物件也可能同時參照一個類別。
您對類別或物件所做的變更會立即生效。使用者進行同步處理作業時,可以在 Google Pay 應用程式中查看這些變更內容。
物件和連結
Google Pay API for Passes 是以 Object
的概念來代表會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證。舉例來說,使用者在 Google Pay 應用程式中擁有的每張會員卡都以一個 LoyaltyObject
表示。
使用者透過 [儲存至 Google Pay] 按鈕儲存會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證時,API 會插入 Object
,並在該物件和使用者之間建立連結。因此,如果使用者再次按一下該按鈕,系統並不會插入新的 Object
。因為連結已存在,所以系統不會再次連結 Object
。
如果使用者從 Google Pay 應用程式中移除票證,系統不會移除使用者連結的 Object
,而是會將其解除連結。如果使用者再次按一下 [儲存至 Google Pay] 按鈕,系統不會建立新的 Object
,而是會重新建立連結。
開發票證時,由於 API 不會重新插入與現有 id
相符的 Object
,因此每次儲存之間應使用新的 Object
id
。
請記得,將票證從帳戶中移除後,並不會真的移除 Object
。Object
只是與您的帳戶解除連結。