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

ご利用にあたって

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

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

API 例外とトラブルシューティング

この例外は何を意味しますか?

Google Wallet API の使用中に API 例外が発生した場合は、次の表で説明と提案をご確認ください。

例外 メッセージ例 提案
400 - BadRequestException リクエストに無効な引数が含まれています。無効なリソース ID: {1234567891234567899 - ABCD1234567}。 タイプのデータ構造、形式、長さを確認し、正しい引数を渡します。
403 - PermissionDeniedException 権限の拒否 サービス アカウントの正しいメールアドレスが、Business Pay and Wallet Console 内で承認されたユーザーであることを確認します。
404 - NotFoundException ウォレット オブジェクト {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} が見つかりません。 PATCH リクエストまたは PUT リクエストを試す前にオブジェクト ID に対して GET を実行し、更新するオブジェクトがあり、それが最新であることを確認します。
404 - IssuerClassNotFoundException ウォレットのオブジェクト クラス {1234567891234567899.ABCD.1234567} が見つかりません。 更新を行う際は、PATCH リクエストまたは PUT リクエストの前に GET リクエストを行って、参照するクラスがあり、それが最新のクラスであることをことを確認します。また、リクエストで正しいペイロード(オブジェクトとクラス)が適切に使用されていることも確認します。
409 - AlreadyExistsException ウォレットのオブジェクト クラス {1234567891234567899.ABCD.1234567} はすでに存在します。 同じクラス ID の作成を試みる前に、クラス ID に対して GET を実行します。リソースが存在する場合は、PATCH または PUT を使用できます。

一般的な質問

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

スマートタップ

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

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

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

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

デベロッパーの設定

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

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

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

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 Pay and Wallet Console からサポートチームにお問い合わせください。

サポートに問い合わせる

フィードバックを送信

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

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

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

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