工作原理

此页介绍了类和对象之间的关系,这是 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 与您帐号的关联。