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 時間前 ドキュメント
搭乗券 次のリマインダー フライトの出発 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 Web Token(JWT)

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

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

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

トラブルシューティング

時間設定に予定の時刻が間違って表示されるのはなぜですか?

パスに表示される時刻は、イベントの現地時刻で、イベント時刻とのオフセットが加えられています。

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

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

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

テクニカル サポートへの連絡方法を教えてください。

さらにサポートが必要な場合は、[サポートへのお問い合わせ] をクリックして、サポートチームにご連絡ください。ボタン(Google Pay & ウォレット コンソールの左側のサイドバーにあります)をクリックします。

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

サービスに関するフィードバックを送信するには、[フィードバックを送信] をクリックします。[Rules] をクリックすると [Product feedback] を選択します。次に テキスト欄にフィードバックを入力して [送信] をクリックします。

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

ドキュメントのフィードバックを送信するには、[フィードバックを送信] をクリックします。[Rules] をクリックすると [Documentation feedback] を選択します。 次に、テキスト欄にフィードバックを入力して [送信] をクリックします。