Google Pay API for Passes

Google Pay API for Passes プラットフォームを使用すると、ポイントカード、ギフトカード、クーポン、イベント チケット、搭乗券、乗車券を多くの Android ユーザーに提示できます。

この API を使用することによって、ポイントカード、ギフトカード、クーポン、イベント チケット、搭乗券、乗車券を Google Pay アプリに保存するリンクやボタンを作成できます。これらのアイテムはオブジェクトとして保存されます。

注: このドキュメントでは、オブジェクトの総称を「パス」と表記しています。各オブジェクトはクラスを参照する必要があります。

この API では、位置情報ベースの通知、更新、メッセージングの機能を活用して、パスを利用するお客様にアプローチできます。パスは Google Pay アプリで簡単に管理できます。

典型的な統合プロセス

次の図は、Google Pay API for Passes との統合の典型的なプロセスを示したものです。

統合の各ステージには以下のアクティビティが含まれます。

1. 技術上の発見
   1. デベロッパー ドキュメントを確認します。
   2. サービス アカウントを作成します。
   3. 統合を設計します。
2. 技術的な統合
   1. 統合を開発します。
   2. 成果物をステージングします。
3. 検証と QA
   1. QA テストを行います。
   2. UX 設計を確認します（搭乗券とイベント チケットの場合のみ）。
4. 展開フェーズ
   1. さまざまな地域で提供を開始します。
   2. クラウドテストを開始します。
5. リリース
   1. すべての地域で提供を開始します。

推奨される統合戦略

Google Pay API for Passes は、次の表に示すカテゴリのパスをサポートしています。表を確認して、パスと統合タイプ別の推奨される統合戦略を選択してください。

注: JSON Web Token（JWT）リンクには事前にクラスが挿入されています。ただし、スリムな JWT リンクはこれに該当しません。

	ポイント プログラム	クーポン	ギフトカード	イベント チケット（ET）	搭乗券（BP）	乗車券（TP）	グループ化されたチケット（BP、ET、TP のみ）
ウェブブラウザ	JavaScript（JS）ウェブボタン	JS ウェブボタン	JS ウェブボタン	JS ウェブボタン	JS ウェブボタン	JS ウェブボタン	JS ウェブボタン
SMS またはメール	JSON Web Token（JWT）リンク	JWT リンク	JWT リンク	スリムな JWT リンク	スリムな JWT リンク	スリムな JWT リンク	スリムな JWT リンク
ネイティブ アプリ	JWT リンク	JWT リンク	JWT リンク	スリムな JWT リンク、JWT POST リクエスト メソッド	スリムな JWT リンク、JWT POST リクエスト メソッド	スリムな JWT リンク、JWT POST リクエスト メソッド	スリムな JWT リンク、JWT POST リクエスト メソッド
WebView	JWT リンク	JWT リンク	JWT リンク	JWT リンク	スリムな JWT リンク	スリムな JWT リンク	スリムな JWT リンク

注意: 可能であれば、パスの統合で WebView を使用せず、ネイティブ アプリからパスを保存するようにユーザーに促します。WebView を使用する場合は、pay.google.com へのリダイレクトを可能にする shouldOverrideUrlLoading メソッドを実装します。この実装のコード スニペットは次のようになります。

@Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if(request.getUrl().getHost().startsWith("pay.google.com")) {
          Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
          view.getContext().startActivity(intent);
          return true;
        }
        ...
        ...
      }

統合戦略で利用できる機能を理解するには、パスと Google Pay に関する以下の情報をご覧ください。

Google Pay に保存

すべてのパスは Google Pay への保存に対応しています。これは、メールまたは SMS に含まれる JavaScript ウェブボタンを使用して行うか、Android アプリケーションで JWT リンクとインテントを使用して行います。加えて、ネイティブ SDK の機能を使用した Android アプリからの保存がどのようにサポートされるかには違いがあります。それらの違いを次の表に示します。

	ポイント プログラム	クーポン	ギフトカード	イベント チケット	搭乗券	乗車券
ネイティブ SDK を使用して Android アプリから保存

詳細については、Google Pay へのパス保存を実装する際の詳細事項をご覧ください。

Google Pay からの利用

すべてのパスは、提示してスキャンによる利用と、NFC タップによる利用をサポートしています。Google Pay からのパス利用を実装する際の詳細事項をご覧ください。

Google Pay を使用したアプローチ

注: プラットフォームの改善中は、大半のユーザーがリンクされたクーポンとジオフェンス通知を一時的に利用できなくなります。これらの機能は今後のリリースで更新される予定です。

すべてのパスは、ビジネス情報セクション、カスタム メッセージ、カスタムのテキストと画像のセクション、利用ステータスをサポートしています。利用ステータスは、ユーザーがパスとローカライズを削除したかどうかを判断します。次の表に、さまざまな種類のパスで独自にサポートされる機能と通知を示します。

	ポイント プログラム	クーポン	ギフトカード	イベント チケット	搭乗券	乗車券
機能
テンプレート
リンクされたクーポン
アシスタントからのクエリ
通知
ジオフェンス通知
有効期限の通知
フィールド更新通知の選択
間近のイベント、フライト、旅程の通知

詳細については、Google Pay を通じたユーザー アプローチを実装する際の詳細事項をご覧ください。

Google Pay アプリでの各機能の外観については、ポイント、ギフトカード、クーポン、イベント チケット、搭乗券、乗車券のパス テンプレート ページをご覧ください。