ポイントカードの更新

パスの更新は、パスの作成後にユーザーとやり取りする重要な手段となります。たとえば、ユーザーがポイントを利用したときにユーザーカードのポイントを更新します。

パスの表示方法を更新するには（ロゴが変更された場合など）、ポイントカード クラスを update または patch するか、Google Pay & Wallet Console を使用するだけで済みます。この情報は、更新されたポイントカード クラスに関連付けられているすべてのポイントカード オブジェクトに反映されます。これは、ポイントカード クラスのレベルで定義されているすべてのフィールドに当てはまります。

1 つのパスを更新するには（ポイントカードのポイント残高が変更された場合など）、1 つのポイントカード オブジェクトを更新するか、パッチを適用する必要があります。これは、ポイントカード オブジェクトのレベルで定義されているすべてのフィールドに当てはまります。

注:

どの更新ロジックも、最初に GET リクエストを行ってクラスまたはオブジェクトを取得する必要があります。これにより、クラスまたはオブジェクトの最新バージョンが確実に使用されます。省略したフィールドは消去されます。

一般的に、変更するフィールドのデータのみを指定する場合は、パッチを使用する方がはるかに安全です。省略したフィールドは消去されません。ただし、配列を変更する場合は特に注意が必要です。配列を含むパッチ リクエストを実行すると、既存の配列も、指定した配列で置換されます。配列内の要素を部分的に変更、追加、削除することはできません。

場合によっては、変更がいつ発生するか、あるいは更新リクエストまたはパッチ リクエストをいつトリガーすればよいかわからないことがあります。そのような場合は、すべてのクラスとオブジェクトそれぞれに対して、更新リクエストまたはパッチ リクエストを定期的にスケジュールします。Loyalty クラスの list メソッドを呼び出すと、特定の発行者アカウントのすべてのクラスを確認できます。Loyalty オブジェクトの list メソッドを呼び出すと、特定のクラスのすべてのオブジェクトを確認できます。