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

背景

この機能により、航空会社は搭乗券をユーザーの Google ウォレットに自動的にプッシュできます。旅行の頻度が高い頻繁な利用者は、搭乗券をウォレットに追加する手間が省け、より簡単に利用できるようになります。

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

この機能の仕組み

ステップ 1: よく利用する航空会社のマイレージ会員証をウォレットに追加できるようにする。

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

ベストプラクティス

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

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

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

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

統合の手順

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

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

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

ISSUERID.PRIMARY_OBJECT_ID
ISSUERID.PRIMARY_CLASS_ID
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 にすでに挿入されている必要があります。
リンクされたオブジェクトには、すでに別のリンクされたオブジェクトがあります。ネストされたリンクオブジェクトを追加することはできません。	リンクされたオブジェクトに別のリンクされたオブジェクトを含めることはできません。
オブジェクトはすでに別のオブジェクトにリンクされています。ネストされたリンクオブジェクトを追加することはできません。	プライマリオブジェクトをリンクオブジェクト単独にすることはできません。

搭乗券を自動的に追加する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

背景