Karty połączone automatycznie

Tło

Funkcja automatycznie połączonych kart umożliwia wysyłanie dodatkowych kart do użytkownika, który ma już Twoją istniejącą kartę w Portfelu Google. Możesz też jest przekazywany na kartę podstawową, gdy użytkownik zapisuje podstawową kartę. (głównego). Automatycznie połączona karta jest zgrupowana z kartą podstawową objaśnienie nad podstawową kartą informujące użytkownika, że została połączone. Te typy kart są obsługiwane jako karty podstawowe lub połączone:

• Bilet na wydarzenie
• Karta pokładowa
• bilet na przejazd,
• Oferta
• Karta podarunkowa
• Karta lojalnościowa
• Bilet standardowy

Podstawowa karta z informacją o dodaniu nowej karty	Nowa karta połączona z kartą podstawową

Przykłady zastosowania

Istnieją różne przypadki użycia funkcji łączenia kart z istniejącą kartą. Niektóre Przykłady:

• Połącz ofertę z istniejącą kartą lojalnościową.
• Połącz kupon na posiłek z kartą pokładową lub biletem na wydarzenie.
• połączyć bilet na parking z biletem na wydarzenie,

Uwagi na temat korzystania z kart połączonych automatycznie

• Obiekt główny i połączony obiekt muszą używać tego samego identyfikatora wydawcy.
• Obowiązuje limit 50 połączonych obiektów na obiekt główny.
• Nie ma gwarancji i nie jest gwarantowane automatyczne przekazywanie połączonych kart. w ramach najlepszych starań. Użytkownicy mogą zrezygnować z otrzymywania automatycznie połączonych kart. Jeśli przypadek użycia to ma kluczowe znaczenie, a użytkownik musi otrzymać powiązaną kartę, zalecamy komunikuje się przez inny kanał, by mieć pewność, że użytkownik dodał kartę.
• Aktualizacja Zasad dopuszczalnego użytkowania Portfela Google zawierają wskazówki dotyczące korzystania z automatycznie połączonych kart, których należy przestrzegać.

Etapy integracji

Jeśli masz już utworzony obiekt główny, możesz pominąć krok 1.

1. Utwórz obiekt dowolnego z wymienionych typów karty z wymaganymi parametrami. Jest to obiekt primary.
2. Utwórz kolejny obiekt dowolnego z wymienionych typów karty. To będzie linked (połączony obiekt).
3. Przed zapisaniem obiektu głównego lub po nim zaktualizuj główny obiekt z identyfikatorem połączonego obiektu w identyfikatorach połączonych obiektów .

Aby można było ustawić identyfikatory połączonychObjectId w instancji głównej, wymagane jest minimalne ładunki pomyślne. Te 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 pomyślnej odpowiedzi urządzenia ze zaktualizowaną kartą powinna otrzymać powiązaną kartę. Ta połączona karta zostanie zgrupowana z: podstawową przepustkę. Użytkownicy mogą wyświetlić połączona kartę, przesuwając palcem w prawo.

Obsługa wyjątków

Potencjalne błędy mogą wystąpić w przypadku niewłaściwego użycia interfejsu API, który może uwzględniać,