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

背景

この機能により、航空会社は搭乗券をユーザーの Google ウォレットに自動的にプッシュできます。旅行の頻度が高い頻繁な利用者は、搭乗券をウォレットに追加する際の煩わしさが軽減されるため、特にメリットがあります。

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

この機能の仕組み

ステップ 1: よく利用するお客様がマイレージ プログラムのポイントカードをウォレットに追加できるようにします。

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

ベスト プラクティス

• 頻繁に飛行機を利用するユーザーがスムーズにロイヤリティ プログラムに登録できるようにするには、Google で登録 / ログインのフローを有効にすることを検討してください。これにより、ユーザーは Google ウォレットのさまざまなエントリ ポイント（搭乗券など）で航空会社のポイント プログラム登録フローを見つけられるようになります。
• Android アプリとウェブサイトで、既存のポイント プログラム メンバー向けにワンクリック登録を有効にすることを検討してください。

注: この機能は、自動リンクされたパス機能の特定の実装です。この場合、プライマリ パスはポイントカード、リンクされたパスは搭乗券を指します。このドキュメントの残りの部分では、この機能を説明するために、より広範な用語（自動リンクされたパス、プライマリ パス、リンクされたパス）を使用します。

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

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

統合の手順

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

1. 必要なパラメータを使用して、リストされている任意のパスタイプのオブジェクトを作成します。これがプライマリ オブジェクトです。
2. リストされているパスタイプの別のオブジェクトを作成します。これは linked オブジェクトになります。
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 を誤って使用すると、次のようなエラーが発生する可能性があります。

メッセージ	理由
メインのオブジェクトとリンクされたオブジェクトの発行元 ID が同じではありません。	リンクされたオブジェクトを別の発行者のオブジェクトに添付することはできません。
プライマリ オブジェクトとリンクされたオブジェクトが同じオブジェクトを参照している。	同じオブジェクトを linkedObject として添付することはできません。
リンクされたオブジェクトが存在しません。	リンクされたオブジェクトは、ウォレット API にすでに挿入されている必要があります。
リンクされたオブジェクトには、すでに別のリンクされたオブジェクトがあります。ネストされたリンク オブジェクトを追加することはできません。	リンクされたオブジェクトに別のリンクされたオブジェクトを含めることはできません。
オブジェクトは別のオブジェクトにすでにリンクされています。ネストされたリンク オブジェクトを追加できません。	プライマリ オブジェクトをリンクされたオブジェクト単独にすることはできません。