類別和物件的運作方式

本頁面說明類別和物件之間的關係,這是 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

請記得,將票證從帳戶中移除後,並不會真的移除 ObjectObject 只是與您的帳戶解除連結。