Automatyczne dodawanie kart pokładowych

Tło

Ta funkcja umożliwia liniom lotniczym automatyczne przesyłanie kart pokładowych do Portfela Google użytkownika. Będzie to szczególnie przydatne dla osób, które często podróżują samolotem. Dzięki większej częstotliwości podróży będą mogły łatwiej i szybciej dodawać karty pokładowe do Portfela.

Dzieje się to automatycznie niezależnie od kanału odprawy (np. internet, aplikacja lub kiosk na lotnisku). Linia lotnicza używa numeru konta w programie lojalnościowym użytkownika do powiązania i przesłania karty.

Uwaga: ta funkcja jest konkretnym wdrożeniem możliwości „Automatycznie połączone karty”. W pozostałej części dokumentu używamy szerszego terminu „Automatycznie połączone karty”, a także „karta główna” i „połączona karta” na określenie tej funkcji.

Jak działa ta funkcja

Krok 1. Zezwól osobie często podróżującej na dodanie karty lojalnościowej do Portfela.

Krok 2. Automatycznie dodawaj nowe karty pokładowe dla pasażera, który często podróżuje, łącząc je z jego kartą lojalnościową w Portfelu.

Uwagi dotyczące korzystania z automatycznie połączonych kart

• Obiekt podstawowy i połączony muszą używać tego samego identyfikatora wydawcy.
• Na każdy obiekt główny może przypadać maksymalnie 50 obiektów połączonych.
• Automatyczne przesyłanie połączonych kart nie jest gwarantowane i jest traktowane jako najlepsza próba. Użytkownicy mogą zrezygnować z otrzymywania automatycznie połączonych dokumentów. Jeśli przypadek użycia jest krytyczny i użytkownik musi otrzymać połączoną kartę, zalecamy komunikację za pomocą innego kanału, aby mieć pewność, że użytkownik doda kartę.
• Aktualizacje zasad dopuszczalnego użytkowania Portfela Google zawierają wytyczne dotyczące korzystania z automatycznie połączonych kart, których należy przestrzegać.

Kroki integracji

Jeśli masz już utworzony obiekt podstawowy, możesz pominąć krok 1.

1. Utwórz obiekt dowolnego typu karty z wymaganymi parametrami. Jest to główny obiekt.
2. Utwórz kolejny obiekt dowolnego wymienionego typu karty. Będzie to połączony obiekt.
3. Przed zapisaniem podstawowego obiektu lub po jego zapisaniu zaktualizuj podstawowy obiekt, podając identyfikator połączonego obiektu w parametrze linkedObjectIds.

Aby ustawić identyfikatory linkedObjectIds w podstawowej karcie, wymagany jest minimalny rozmiar ładunku. 3 wymagane parametry to:

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

Przykładowe żądanie JSON dodania połączonego obiektu do obiektu karty

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

Przykładowa odpowiedź JSON po połączeniu obiektu z obiektem karty

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

oczekiwane zachowanie;

Po otrzymaniu odpowiedzi z potwierdzeniem urządzenia z zaktualizowaną kartą powinny otrzymać powiązaną kartę. Połączony dokument zostanie zgrupowany z dokumentem podstawowym. Użytkownicy mogą zobaczyć połączony dokument, przesuwając palcem w prawo.

Obsługa wyjątków

W przypadku nieprawidłowego użycia interfejsu API mogą wystąpić błędy, w tym: