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.
- Utwórz obiekt dowolnego z wymienionych typów karty z wymaganymi parametrami. Jest to obiekt primary.
- Utwórz kolejny obiekt dowolnego z wymienionych typów karty. To będzie linked (połączony obiekt).
- 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:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- 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ć,
Wiadomość | Uzasadnienie |
---|---|
Obiekt główny i połączony obiekt nie mają tego samego wydawcy ID. | Nie można dołączyć połączonego obiektu do obiektu innego wydawcy. |
Obiekt główny i połączony obiekt odwołują się do tego samego obiektu. | Nie możesz dołączyć tego samego obiektu co połączonyObject. |
Połączony obiekt nie istnieje. | Połączony obiekt powinien być już wstawiony do Portfela API. |
Połączony obiekt ma już inny połączony obiekt. Nie można dodać zagnieżdżonych połączone obiekty. | Połączone obiekty nie mogą mieć kolejnego połączonego obiektu. |
Obiekt jest już połączony z innym obiektem. Nie można dodać zagnieżdżonego linku obiektów. | Obiekt główny nie może być samodzielnie połączonym obiektem. |
Nie można dodać więcej połączonych obiektów. Przekroczono limit. | Na karcie podstawowej osiągnięto limit 50 połączonych kart pomyślne. |