Google Wallet API に関するよくある質問

スタートガイド

Google Wallet API とはどのようなものですか？

Google Wallet API を使用すると、デベロッパーは、Google ウォレットでデジタルパスを作成できます。現在、Google Wallet API では、搭乗券、イベント チケット、ポイントカード、クーポン、交通機関のパスがサポートされています。さらに最近では、他のユースケースをサポートするために汎用パスタイプが追加されました。

ビジネスの要件と複雑さに応じて開発環境を設定するにはどうすればよいですか？

ビジネスの複雑さやセキュリティのレベルに応じて開発環境を設定するためのガイドを以下に示します。複数のサービス アカウントを使用することで、デベロッパーは本番環境とは別にテスト環境を作成できます。

基本的な複雑さの場合の設定

1 つの Business Console アカウント、または Business Console の 1 つの親アカウントを、多数の発行者アカウントに関連付けます。

  • この方法では、1 つのメイン アカウントを使用し、その下に 0 個以上のサブビジネス/発行者を置くことで一元管理型のアプローチが可能です。
  • 1 つの Google Cloud プロジェクト。
  • 1 つのサービス アカウント認証情報。
  • ユーザーの単一セット。

平均的な複雑さの場合の設定

1 つの親アカウントを多くの発行者アカウントに関連付けます。

  • この方法では、1 つのメイン アカウントを使用し、その下に多数のサブビジネスを置くことで一元管理型のアプローチが可能です。
  • 1 つの Google Cloud プロジェクト。
  • 発行者ごとに個別の Business Console ユーザーを使用。
  • 1 対多のサービス アカウント認証情報。
    • ビジネス/発行者ごとに 1 つの認証情報を使用。
    • ビジネスごとに異なる認証情報アクセス。

複雑な設定の複雑さ

1 つの親アカウントを多くの発行者アカウントに関連付けます。

  • この方法では、1 つのメイン アカウントを使用し、その下に多数のサブビジネスを置くことで一元管理型のアプローチが可能です。
  • 1 対多の Google Cloud プロジェクト。
  • 発行者ごとに個別の Business Console ユーザーを使用。
  • 1 対多のサービス アカウント認証情報。
    • ビジネス/発行者ごとに 1 つの本番用認証情報。
    • ビジネス/発行者ごとに 1 つの開発用認証情報。

サポートに問い合わせる

パスの操作

クラスまたはオブジェクトを削除するにはどうすればよいですか？

現時点では、Google ウォレットからクラスまたはオブジェクトを削除することはできません。ただし、ユーザーは Google ウォレットのオブジェクトのリンクを解除できます。

複数のパスをグループ化するにはどうすればよいですか？

GroupingID を使用すると、パスを簡単にグループ化できます。

パスの一部のみを更新するにはどうすればよいですか？

パフォーマンス ガイドで、PATCH リクエストを使用して部分更新を実行する方法をご確認ください。

複数のパスを一括作成することはできますか？

API を使用してバッチ リクエストを実行する方法については、パフォーマンス ガイドをご覧ください。

一般的な質問

Google Wallet API に送信されるリクエストのレート上限はどのくらいですか？

Google Wallet API への呼び出しは、1 秒あたり 20 件のリクエストに制限されています。

Google Wallet API には公式の SLA はありませんが、レイテンシの 99 パーセンタイル値が約 5 秒であることから、10 秒のタイムアウトをおすすめします。また、レイテンシは外部要因に依存することがよくあります。たとえば、その画像を含むオブジェクトを挿入するときに外部サーバーでホストされている画像を取得するのに必要な時間は、外部サーバーのレイテンシに依存します。

Google ウォレットのパスに個人の画像を使用することが禁止されているのはなぜですか？

Google ウォレットでは、パスに個人の画像を使用することはできません。これは、現在の規制で、すべての消費者がセンシティブ データの収集または処理をオプトアウトする権利を有すると定められているためです。機密データ（個人画像）が貴重なオブジェクト（JWT 内）の一部として存在する場合、データが公開される可能性があり、元の同意契約の範囲外となるため、ホスティングに関する懸念が生じる可能性があります。データの機密性を確保するため、個人の画像は許可されていません。今後、個人用画像のサポートに取り組んでまいります。

Google Wallet API から返されるエラーコードは何ですか？

Google Wallet API から返されるエラーコードと例外の一覧については、エラーコードをご覧ください。

プッシュ通知を有効にするにはどうすればよいですか？

現在 Google ウォレットでは、デベロッパー作成のプッシュ通知はサポートされていません。ただし、Google ウォレットでは次のパスの通知がタイムリーに提供されます。現在 Google ウォレットでは、デベロッパー作成のプッシュ通知はサポートされていません。

業種 通知 トリガーされた実行 ドキュメント
イベント 次のリマインダー イベントの 3 時間前 ドキュメント
搭乗券 次のリマインダー フライトの出発 3 時間前 ドキュメント
搭乗券 パスの更新 出発地のターミナル、ゲート、搭乗時刻、出発時刻の変更 ドキュメント
特典カード 有効期限のリマインダー クーポンの有効期限が切れる 48 時間前 ドキュメント
汎用 次のリマインダー 「期間」が始まる 24 時間前 ドキュメント
汎用 有効期限のリマインダー 「期間」が終了する 48 時間前 ドキュメント

販売者 ID は削除できますか？

現時点では、販売者 ID を Google Pay & ウォレット コンソールから削除したり、アーカイブしたりすることはできません。

アプリのリンク機能を使用するにはどうすればよいですか？

アプリをリンクするには、許可リストへの登録が必要です。こちらからリクエストできます。

Google ウォレットはジオフェンスに対応していますか？

ジオフェンスは現在サポートされていません。

ポイント プログラムを設定するにはどうすればよいですか？

こちらのガイドに沿って登録とポイント プログラムを設定できます。

交通機関のパスのロゴを Google に送信するにはどうすればよいですか？

こちらのフォームを使用して、許可リスト用のロゴを Google に送信してください。

Base64 でエンコードされた userProfile データを正しく処理するにはどうすればよいですか？

プロセス全体で UTF-8 エンコードを使用してください。JSON 文字列は最初に UTF-8 でエンコードされ、その後、android.util.Base64 を使用してエンコードされます（NO_WRAP と URL_SAFE オプションを使用）。これは RFC 3548 セクション 4 に対応しています。

発行者アカウントをプログラマティックに作成するにはどうすればよいですか？

API を使用して発行者アカウントを作成する方法については、こちらのガイドをご覧ください。

スマートタップ

Google SmartTap パスには特別な NFC リーダーが必要ですか？

SmartTap 対応端末である必要があります。認定プロバイダの一覧は、こちらで確認できます。

NFC でパスを機能させるにはどうすればよいですか？

パスをスマートタップで利用できるようにするには、こちらの設定を行ってください。

JSON ウェブトークン（JWT）

JWT の実装とデバッグを簡素化するツールはありますか？

はい。www.jwt.io などのプラットフォームでは、開発プロセス中にトークンのデコードやデバッグを行うことができるため、送信するコンテンツを確認できます。ただし、Google との提携関係はなく、そのようなサードパーティを特におすすめするわけではありません。

パス保存リンク（JWT）を作成する前に、API を使用して クラスとオブジェクトを事前に作成 できます。

トラブルシューティング

時間設定にイベントの時刻が誤って表示されるのはなぜですか？

パスに表示される時間は、イベントの現地時刻に、当地に対する時差を適用した時刻です。

作成したパスにロゴが表示されません。どのような問題が考えられますか？

  • まず、ロゴがガイドラインに準拠しており、PNG 形式で保存されていることを確認してください。
  • 高い信頼性をもってロゴにアクセスできることを確認してください。404 エラーとなる画像ファイルにリダイレクトしないでください。画像は HTTPS の場所でホストされている必要があります。それ以外の場合、Google ウォレットでは表示されません。
  • パスで API のすべての必須フィールドが設定されていることを確認してください。

サポートとフィードバック

テクニカル サポートに問い合わせるにはどうすればよいですか？

サポートが必要な場合は、Google Pay and Wallet Console の左側のサイドバーにある [サポートに問い合わせる] ボタンをクリックして、サポートチームにお問い合わせください。

プロダクトのフィードバックを送信するにはどうすればよいですか？

プロダクト フィードバックを送信するには、デベロッパー サイトページの右上にある [フィードバックを送信] ボタンをクリックし、[サービスに関するフィードバック] を選択します。次に、テキスト欄にフィードバックの内容を入力して [送信] をクリックします。

ドキュメントのフィードバックを送信するにはどうすればよいですか？

ドキュメントのフィードバックを送信するには、デベロッパー サイトページの右上にある [フィードバックを送信] ボタンをクリックし、[ドキュメントに関するフィードバック] を選択します。次に、テキスト欄にフィードバックの内容を入力して [送信] をクリックします。