このページでは、Google Wallet API の仕組みの基礎となるクラスとオブジェクトの関係について説明します。また、オブジェクトがユーザーにどのようにしてリンクされるかについても説明します。
クラスとオブジェクト
Google Wallet API は、オブジェクトのコンセプトを使用して、1 人のユーザーの実際のクーポンをデジタル化します。この API は、クラスのコンセプトを使用して、すべてのユーザーに共通するデータの管理を可能にします。特定のユースケースに対応するため、それぞれのカテゴリに独自のオブジェクトとクラスがあります。
たとえば、ユーザーが Google ウォレット アプリに保存している各 Google ウォレットは 1 つの OfferObject
で表されます。これは OfferClass
を参照します。
すべてのクーポンに適用する変更を簡単に実装できるように、すべてのオブジェクトがクラスを参照します。
クラスには、オブジェクト全体の共通データが含まれます。たとえば、OfferClass
は redemptionChannel
を格納しますが、OfferObject
は個々の barcode
を格納します。クラスとオブジェクトの関係は 1 対 1 にできますが、1 つのクラスを複数のオブジェクトから参照することも可能です。
クラスまたはオブジェクトに対する変更はすぐに適用されます。こうした変更は、同期後に Google ウォレット アプリに反映されます。
オブジェクトとリンク
Google Wallet API は、Object
のコンセプトを使用してクーポンを表します。たとえば OfferObject
は、ユーザーが Google ウォレット アプリに保存している各クーポンを表します。
ユーザーが [Google ウォレットに追加] ボタンをクリックしてクーポンを追加すると、API によって Object
が挿入され、そのオブジェクトとユーザー間のリンクが確立されます。つまり、ユーザーがボタンを再度クリックしたとき、Object
へのリンクはすでに存在します。
ユーザーが Google ウォレット アプリからパスを削除すると、対応する Object
へのリンクが解除されます。つまり、ユーザーが [Google ウォレットに追加] ボタンをもう一度クリックすると、新しい Object
を作成せずにリンクが再確立されます。
パスを開発する際は、オブジェクトを追加するたびに新しい Object
id
を使用することをおすすめします。これは、id
が一致する場合、API は Object
を再挿入しないためです。
アカウントからパスを削除しても、Object
は失われません。Object
とアカウントのリンクが解除されるだけであり、再びリンクできます。