搭乗券を自動的に追加する

背景

この機能により、航空会社は搭乗券をユーザーの Google ウォレットに自動的にプッシュできます。これにより、旅行頻度の高いお客様は、搭乗券をウォレットに追加する際の煩わしさが軽減され、より簡単に手続きできるようになります。

これは、チェックイン チャネル（ウェブ、アプリ、空港のキオスクなど）に関係なく自動的に行われます。航空会社は、ユーザーのポイント プログラム アカウント番号を使用してパスを関連付け、プッシュします。

注: この機能は、「自動リンクされたパス」機能の特定の実装です。このドキュメントの残りの部分では、この機能を説明するために、「自動リンクされたパス」という広範な用語と、「プライマリ パス」と「リンクされたパス」という用語を使用します。

この機能の仕組み

ステップ 1: 常連客がポイント カードをウォレットに追加できるようにします。

ステップ 2: ウォレットのポイントカードにリンクして、フリークエント フライヤーの新しい搭乗券を自動的に追加します。

自動リンクされたパスを使用する際の考慮事項

• メイン オブジェクトとリンクされたオブジェクトは同じ issuerId を使用する必要があります。
• 1 つのプライマリ オブジェクトにリンクできるオブジェクトは 50 個までです。
• リンクされたパスを自動的にプッシュすることは保証されておらず、ベスト エフォートと見なされます。ユーザーは自動リンクされたパスの受信をオプトアウトできます。ユースケースが重要で、ユーザーがリンクされたパスを受け取る必要がある場合は、別のチャネルを通じて連絡を取り、ユーザーがパスを追加できるようにすることをおすすめします。
• Google ウォレットの AUP の更新には、自動リンクされたパスの使用に関するガイダンスが含まれており、これに準拠する必要があります。

統合の手順

プライマリ オブジェクトをすでに作成している場合は、ステップ 1 をスキップできます。

1. 必要なパラメータを使用して、リストされているパスタイプのオブジェクトを作成します。これがプライマリ オブジェクトです。
2. 記載されているいずれかのパスタイプの別のオブジェクトを作成します。これはリンクされたオブジェクトになります。
3. プライマリ オブジェクトを保存する前または後に、linkedObjectIds パラメータのリンクされたオブジェクトの ID を使用してプライマリ オブジェクトを更新します。

プライマリ パスに linkedObjectIds を設定するには、最小ペイロードが必要です。3 つの必須パラメータは次のとおりです。

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

パス オブジェクトにリンクされたオブジェクトを追加する JSON リクエストの例

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

オブジェクトをパス オブジェクトにリンクした後の JSON レスポンスの例

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

予想される動作

成功レスポンスを受け取ると、更新したパスを含むデバイスはリンクされたパスを受け取ります。このリンクされたパスは、メインパスとともにグループ化されます。リンクされたパスは、右にスワイプすると表示されます。

例外処理

API を誤って使用すると、次のようなエラーが発生する可能性があります。