交通機関のパスを更新する

パスの更新は、パスの作成後にユーザーとやり取りする重要な手段となります。たとえば、ユーザーがアプリから購入を行った場合にカード残高を更新することなどです。

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

1 つのパスを更新（交通機関のパスの残高の変更など）するには、1 つの Transit Pass オブジェクトに対して更新またはパッチを実行する必要があります。Transit Pass オブジェクトのレベルで定義されているすべてのフィールドが、これに該当します。

注:

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

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

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