このページは Cloud Translation API によって翻訳されました。

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 ウォレットのパスには個人の画像を設定できないのはなぜですか？

現在の規制では、すべての消費者がセンシティブデータの収集や処理からオプトアウトする権利が定められているため、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 Web Token（JWT）

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

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

JWT リンクの URL がブラウザの制限である 1,800 文字を超えています。必要な対策

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

トラブルシューティング

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

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

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

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

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

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

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

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

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

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

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