汎用パスは、ユースケースが他の事前定義済みパスタイプに当てはまらない場合に使用できます。チケット、ポイントカード、クーポンなど、ユースケースに固有のフィールドや機能を含む他のパスとは異なり、汎用パスは、カスタムラベルと値を定義できるフィールドを提供することで、さまざまな目的に対応できる柔軟性を備えています。
サンプル ユースケース
汎用パスタイプでできることの例をいくつか紹介します。
- 駐車パス
- 図書館カード
- 会員カード
- 保険証
- 予約の確認
- お客様の事前スクリーン確認コード
機密情報を含むパス
パスまたはユースケースに、個人を特定できる情報(PII)や健康に関するデータなどの機密情報が含まれている場合があります。このような場合は、承認済みのユースケースに汎用プライベート パスタイプを使用できます。詳細については、汎用プライベート パスのドキュメントと利用規定(AUP)をご覧ください。
対応プラットフォーム
Google Wallet API を使用すると、ユーザーが Google ウォレットに保存できるパスを発行できます。このパスは、モバイルアプリなどの複数のプラットフォームや、ウェブサイト、メール、SMS メッセージなど、ハイパーリンクがサポートされている場所であればどこでも保存できます。
API と SDK
Google Wallet API には、パスを迅速かつ簡単に発行、管理できる REST API と Android SDK が用意されています。
- Google Wallet REST API
ウェブ、iOS、モバイルアプリ、メール、SMS などのプラットフォームで「Google ウォレットに追加」リンクを使用してパスを発行するには、Google Wallet REST API を使用することをおすすめします。この API には、パスのさまざまなコンポーネントを作成、取得、更新できる一連のエンドポイントが用意されています。
- Google ウォレット Android SDK
Android アプリでパスを発行するには、Google ウォレット Android SDK を使用することをおすすめします。この SDK には、ネイティブ コードを使用して Google Wallet API をモバイルアプリに簡単に統合できる、さまざまな便利なメソッドが用意されています。
注: Google Wallet API でパスを発行する際に、Google Wallet REST API または Google Wallet Android SDK を使用する必要はありませんが、使用することを強くおすすめします。REST API や Android SDK を使用せずにパスを発行する方法については、JWT でのパス オブジェクトとパスクラスの作成をご覧ください。
要件
Google Wallet API を使用してパスを発行するには、まず次の操作を行う必要があります。- Google Wallet API 発行者アカウントを作成します。
- Android 以外のデベロッパー: Google Cloud アカウントを作成します。
- Android デベロッパー: Google Play 開発者サービスをセットアップする
Google Wallet API のスタートガイド
Google Wallet API の使用を開始する前に、基本機能と用語を理解するのに役立つ以下の記事をご覧ください。- 主なコンセプトと用語: この記事では、Google Wallet API を使用するうえで必要な重要な用語と機能について説明します。
- パスのクラスとオブジェクトの概要: ユーザーに発行するパスは、パスのクラスとパスのオブジェクトを組み合わせて作成されます。この記事では、これら 2 つのコンセプトと、それらを使用してパスを作成する方法について説明します。
- Google ウォレットのパスの開発フロー: この記事では、Google Wallet API を使用してパスを作成するために必要なすべての手順の概要を、最初から最後まで説明します。
ツールとリソース
- Codelabs
セルフガイドの Codelab では、Google ウォレットにパスを追加するために必要な手順について説明しています。実装が Android デバイスのみになる場合は、[Android] を選択します。実装が Android、ウェブ、メール、SMS をサポートする場合は [ウェブ] を選択します。
- パスビルダー
パスビルダー ツールを使用して最初のパスを視覚的に作成し、Google Wallet API でパスを作成するために必要な JSON を自動的に生成します。
- Google ウォレットの GitHub
Google ウォレットの GitHub 組織で、さまざまなプログラミング言語に対応した便利なツール、ライブラリ、サンプルコードを入手できます。