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 から返されるエラーコードにはどのようなものがありますか?

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

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

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

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

販売者 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 & ウォレット コンソールの左側のサイドバーにある [サポートへのお問い合わせ] ボタンをクリックして、サポートチームにお問い合わせください。

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

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

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

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