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, ponieważ będą mogły łatwiej i wygodniej dodawać karty pokładowe do Portfela.

Dzieje się to automatycznie niezależnie od kanału odprawy (np. internet, aplikacja lub kiosk na lotnisku). Partnerzy linii lotniczych mogą używać numeru konta lojalnościowego użytkownika do powiązania i przesłania karty do Portfela.

Jak działa ta funkcja

Krok 1. Umożliw podróżnemu dodanie karty lojalnościowej programu dla często podróżujących do Portfela.

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

Sprawdzone metody

• Aby umożliwić częstym pasażerom łatwą rejestrację w programie lojalnościowym, rozważ włączenie procesu rejestracji lub Zaloguj się przez Google. Użytkownicy będą mogli znaleźć proces rejestracji w programie lojalnościowym Twoich linii lotniczych w różnych miejscach w Portfelu Google, w tym na kartach pokładowych.
• Rozważ włączenie rejestracji jednym kliknięciem dla obecnych uczestników programu lojalnościowego w aplikacji na Androida i witrynie.

Uwaga: ta funkcja jest konkretnym wdrożeniem funkcji automatycznego łączenia kart. W tym kontekście karta podstawowa to karta lojalnościowa, a połączona karta to karta pokładowa. W pozostałej części tego dokumentu używamy szerszej terminologii – automatycznie połączone karty, karta podstawowa i połączona karta – do opisania tej funkcji.

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

• Obiekt podstawowy i połączony muszą używać tego samego identyfikatora wydawcy.
• 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ą wskazówki dotyczące korzystania z automatycznie połączonych kart, których należy przestrzegać.

Integracja

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 obiektu podstawowego lub po jego zapisaniu zaktualizuj obiekt podstawowy, podając identyfikator połączonego obiektu w parametrze linkedObjectIds.

Aby ustawić identyfikatory linkedObjectIds w podstawowej karcie, wymagany jest minimalny rozmiar ładunku. Wymagane są 3 parametry:

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"
  }
  …

Obsługa wyjątków

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

Wiadomość	Uzasadnienie
Obiekt główny i obiekt połączony nie mają tego samego identyfikatora wydawcy.	Nie możesz dołączyć połączonego obiektu do obiektu innego wydawcy.
Obiekt główny i obiekt połączony odnoszą się do tego samego obiektu.	Nie możesz dołączyć tego samego obiektu jako linkedObject.
Połączony obiekt nie istnieje.	Połączony obiekt powinien być już wstawiony do interfejsu Wallet API.
Połączony obiekt ma już inny połączony obiekt. Nie można dodawać zagnieżdżonych połączonych obiektów.	Połączone obiekty nie mogą mieć innego połączonego obiektu.
Obiekt jest już połączony z innym obiektem. Nie można dodawać zagnieżdżonych połączonych obiektów.	Obiekt podstawowy nie może być samodzielnym obiektem połączonym.