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 szybciej 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żliwienie osobie często podróżującej dodania karty lojalnościowej programu dla osób często podróżujących 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.

Sprawdzone metody

• Aby umożliwić pasażerom często podróżującym bezproblemową rejestrację w programie lojalnościowym, rozważ włączenie procesu Rejestracja / logowanie przez Google. Użytkownicy będą mogli odkryć 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 działanie podejmowane w miarę możliwości. 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"
  }
  …

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ą zawierać innych połączonych obiektów.
Obiekt jest już połączony z innym obiektem. Nie można dodawać zagnieżdżonych połączonych obiektów.	Obiekt główny nie może być samodzielnym obiektem połączonym.