ギフトカードの登録(ログイン)機能を使用すると、ユーザーは Google ウォレットに追加してください。 ユーザーはモバイル向けサイトにリダイレクトされ、そこで 完了すると、Google ウォレットにカードを追加できるようになります。
このガイドでは、必要な実装手順の概要を説明します。 にアクセスして、この機能をギフトカード プログラムで有効にしてください。
概要
開始するには、以前にプロジェクトを設定していて、 Google Wallet API。
ログイン機能を実装するには、次の 4 つのステップを行う必要があります。 2023 年 12 月 31 日まで:
- Google ウォレットで、ログインフローをテストするためのテストクラスを設定します。
- Google ウォレット
SharedDataType
を使用するログインページを開発します。 - ログイン後の Google ウォレットへのギフトカードのプッシュバックを実装します。
- 確認と有効化をリクエストします。
Google ウォレットでテストクラスを設定する
ログイン URL(プログラムのロゴ)を確認します。次に、
ネストされたフィールド discoverableProgram
を
giftcardclass
で
使用します。
discoverableProgram
の値を設定して、下書きバージョンを作成します。
。テスターに表示されるようにするには、
テスターが Google Pay & ウォレット コンソールにアクセスできることを確認します。スペースを共有する方法については、
他のユーザーによる Google Pay and Wallet Console へのアクセスについては、以下をご覧ください。
[ユーザー] ページの詳細
開発中に実装の機能の検証を完了するため Google Pay & ウォレット コンソールのサポートへのお問い合わせウィジェットを使用して Google にお問い合わせください。参加中 コンソールで、トピックで [Google Wallet API] を選択してから [Gift card sign-in] を選択します。 サブトピックを作成します。
Google ウォレットのユーザーデータを使用するログインページを開発する
ユーザーがギフトカードの追加を選択すると ウェブサイト上の専用ページにリダイレクトされ、 表示されます。
ユーザーがログインできるログイン URL を指定する必要があります 既存のアカウントにリンクすることはできません。
ログインページは、次の要件を満たしている必要があります。
- モバイル フレンドリーなユーザー エクスペリエンスを提供する。
- ユーザーが 1 つのページでログインを完了できるようにします。
- 有効な証明書による
HTTPS
暗号化を使用して、ユーザーデータが 安全に送信されます。 - ログインページの稼働時間を 99.9% 以上にする。
ログインページを表示すると、Google ウォレットによって
Android WebView と、指定されたプロパティに対して POST
リクエストが行われる
URL。ユーザーデータはパラメータ SharedDataType
で提供されます
これは POST
リクエストに含まれ、
<ph type="x-smartling-placeholder"></ph>
application/x-www-form-urlencoded のコンテンツ タイプと
UTF-8
エンコード。SharedDataType
の値
パラメータは、Base64 でエンコードされた JSON オブジェクトです。
Google ウォレットへのギフトカードの即時プッシュバックを実装する
ページが認証(ログイン)されると、 お客様のギフトカードを直ちに Google ウォレットに差し戻します。
ギフトカードを Google ウォレットにプッシュバックするには、 その構造に従ったリンクが
https://pay.google.com/gp/v/save/{jwt_generated}
URL の安全な長さは 2,000 文字です。リンクは この上限を超えないようにします。JWT でエンコードされたオブジェクトは、サイズが小さく、 ユーザー固有のデータを格納できますほとんどのデータはオブジェクトのクラスに保持するようにし、 作成する必要があります。制限に収まらない大きなオブジェクトについては、 まず、Terraform でオブジェクトを作成し、 Google Wallet API。JWT でオブジェクト ID のみを送信する。
一般的な通信フロー
ユーザーがログインを完了する際の通信フローを図解しています。 次の画像をご覧ください。「サーバー」間のすべてのアクションお客様の責任で実装してください。
確認と有効化をリクエストする
開発作業を完了し、ログインフローをテストしたら、リクエストを送信します。 から Google Pay & ウォレット コンソールからのサポートへのお問い合わせ 追加します。
実装を全面的に審査し、 Google ウォレット アプリと連携させると、ギフトカードのログイン機能が 公開されていますこれにより すべてのユーザーが この機能をご利用いただけます。
最適なユーザー エクスペリエンスを実現するため、ログインの定期的なチェックを 機能要件への継続的な準拠を保証するために実施されます。 ログイン機能に差異がある場合は、通知が届きます 無効になることがあります。
よくある質問
- ギフトカード プログラムで使用する画像に要件はありますか?
- はい。画像は
HTTPS
か所でホストする必要があります それ以外の場合、Google ウォレットでは表示されません。
- はい。画像は
- JWT の実装とデバッグを簡素化するツールはありますか?
- はい。 www.jwt.io を使用すると、 開発中にトークンをデバッグしてデバッグできるため、 確認しましょう。なお、Google との提携関係はなく、 そのような第三者を特に推奨するものではありません。
- Base64 でエンコードされた SharedDataType データを正しく処理するにはどうすればよいですか?
- プロセス全体で UTF-8 エンコードを使用してください。JSON 文字列 最初に UTF-8 でエンコードされ、その後 android.util.Base64 を NO_WRAP と URL_SAFE のオプションで置き換えます。これは次に対応します: RFC 3548 セクション 4