Ogólne omówienie karty

Karta Ogólna jest dostępna, gdy Twój przypadek użycia nie pasuje do żadnego z innych wstępnie zdefiniowanych typów kart. W przeciwieństwie do innych kart, które zawierają pola i funkcje specyficzne dla danego przypadku użycia, takie jak bilety, karty lojalnościowe i oferty, karta ogólna musi być wystarczająco elastyczna, aby można ją było wykorzystać w różnych celach, ponieważ zawiera pola, w których można definiować etykiety własne i wartości.

Przykłady użycia

Oto kilka przykładów tego, co możesz zrobić przy użyciu karty ogólnej:

  • bilety parkingowe.
  • karty biblioteczne,
  • Karty członkowskie
  • Karty ubezpieczenia
  • Potwierdzenia rezerwacji
  • Kody potwierdzenia dla klienta przed ekranem

Karty zawierające informacje poufne

Czasami Twoja karta lub przypadek użycia mogą zawierać informacje poufne, takie jak informacje umożliwiające identyfikację i dane dotyczące zdrowia. W takich sytuacjach ogólny typ dokumentu prywatnego jest dostępny w przypadku wstępnie zatwierdzonych przypadków użycia. Więcej informacji znajdziesz w ogólnej dokumentacji dokumentów prywatnych i w zasadach dopuszczalnego użytkowania.

Obsługiwane platformy

Dzięki interfejsowi Google Wallet API możesz wydawać użytkownikom karty, które będą mogli zapisywać w Portfelu Google, na różnych platformach, w tym w aplikacjach na Androida i wszędzie tam, gdzie są obsługiwane hiperlinki, np. w witrynach, e-mailach czy SMS-ach.

Interfejsy API i pakiety SDK

Interfejs API Portfela Google udostępnia interfejs API typu REST i pakiet SDK do Androida, które pomagają w szybkim i łatwym udostępnianiu kart oraz zarządzaniu nimi.

  • Interfejs API Portfela Google typu REST

    Aby wysyłać karty na platformach takich jak internet, e-mail lub SMS, zalecamy użycie interfejsu API REST Portfela Google. Interfejs API udostępnia zestaw punktów końcowych, które umożliwiają tworzenie, pobieranie i aktualizowanie różnych komponentów kart.

  • Pakiet SDK Portfela Google na Androida

    Aby wydawać karty w aplikacji na Androida, zalecamy korzystanie z pakietu SDK Portfela Google na Androida. Pakiet SDK udostępnia wiele dogodnych metod, które ułatwiają integrację interfejsu API Portfela Google z aplikacjami mobilnymi za pomocą kodu natywnego.

Uwaga: do generowania kart za pomocą interfejsu API Portfela Google nie jest wymagane używanie interfejsu API Portfela Google typu REST API ani pakietu SDK Portfela Google na Androida, ale zdecydowanie zalecamy jego stosowanie. Więcej informacji o wydawanie kart bez używania interfejsu API REST lub pakietu Android SDK znajdziesz w artykule Tworzenie obiektów kart i klas kart w tokenie JWT.

Wymagania

Aby wydawać karty za pomocą interfejsu Google Wallet API, musisz najpierw wykonać te czynności:

Pierwsze kroki z interfejsem Google Wallet API

Zanim zaczniesz korzystać z interfejsu Google Wallet API, zapoznaj się z tymi przydatnymi artykułami, które pozwolą Ci zapoznać się z podstawowymi funkcjami i terminologią.
  • Kluczowe pojęcia i terminy: w tym artykule poznasz wszystkie ważne terminy i funkcje, które są potrzebne podczas korzystania z interfejsu Google Wallet API.
  • Przegląd klas i obiektów kart: karty, które wydajesz użytkownikom, są tworzone przez połączenie klasy kart z obiektami kart. W tym artykule poznasz oba te pojęcia oraz dowiesz się, jak można ich używać do tworzenia kart.
  • Proces tworzenia karty w Portfelu Google: ten artykuł zawiera kompleksowy przegląd wszystkich kroków, które należy wykonać, aby utworzyć kartę za pomocą interfejsu Google Wallet API.

Narzędzia i zasoby

  • Ćwiczenia z programowania

    Samodzielne ćwiczenia z programowania przeprowadzą Cię przez proces dodawania karty do Portfela Google. Na początek wybierz „Android”, jeśli implementacja będzie dostępna tylko na urządzeniach z Androidem. Jeśli Twoja implementacja obsługuje Androida, internet, e-mail lub SMS, wybierz „Sieć”.

    Android Internet

  • Kreator kart

    Utwórz wizualnie pierwszą kartę za pomocą narzędzia do tworzenia kart i automatycznie wygeneruj plik JSON potrzebny do utworzenia karty za pomocą interfejsu Google Wallet API.

  • GitHub

    W witrynie Portfela Google na GitHubie znajdziesz przydatne narzędzia, biblioteki i przykładowy kod w różnych językach programowania.