Ogólne informacje o karcie

Karta ogólna jest dostępna wtedy, gdy Twój przypadek użycia nie pasuje do żadnego z innych wstępnie zdefiniowanych typów kart. W przeciwieństwie do innych dokumentów, które zawierają pola i funkcje specyficzne dla konkretnego przypadku użycia, takie jak bilety, karty lojalnościowe i oferty, karta standardowa jest na tyle elastyczna, że może służyć do różnych celów. Jej zadaniem jest dostarczanie pól, w których można definiować niestandardowe etykiety i wartości.

Przykłady użycia

Oto kilka przykładów tego, co możesz zrobić za pomocą karty ogólnej:

  • bilety parkingowe.
  • karty biblioteczne,
  • Karty członkowskie
  • Karty ubezpieczeniowe
  • Potwierdzenia rezerwacji
  • Kody potwierdzenia 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 tych przypadkach ogólny typ dokumentu prywatnego jest dostępny dla wstępnie zatwierdzonych przypadków użycia. Więcej informacji znajdziesz w ogólnej dokumentacji dokumentu prywatnego i zasadach dopuszczalnego użytkowania.

Obsługiwane platformy

Dzięki interfejsowi Google Wallet API możesz wystawiać karty, które będą zapisywane w Portfelu Google dla użytkowników na różnych platformach, w tym w aplikacjach na Androida, i wszędzie tam, gdzie są obsługiwane hiperlinki, np. na stronach internetowych, w e-mailach i SMS-ach.

Interfejsy API i pakiety SDK

Google Wallet API udostępnia interfejs API typu REST i pakiet SDK na Androida, które pozwalają szybko i łatwo wydawać karty oraz nimi zarządzać.

  • Interfejs API Portfela Google typu REST

    Aby wystawiać 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

    Do wystawiania kart w aplikacji na Androida zalecamy używanie pakietu SDK Portfela Google na Androida. Pakiet SDK udostępnia wiele dogodnych metod, które ułatwiają integrację interfejsu Google Wallet API z aplikacjami mobilnymi za pomocą kodu natywnego.

Uwaga: do wystawiania kart za pomocą interfejsu Google Wallet API nie jest wymagane używanie interfejsu Google Wallet API typu REST API ani pakietu SDK Portfela Google na Androida, ale jest to zdecydowanie zalecane. Więcej informacji o wystawianiu kart bez użycia interfejsu API REST lub pakietu SDK Androida 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 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 terminologia: w tym artykule poznasz wszystkie ważne terminy i funkcje związane z interfejsem API Portfela Google.
  • 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 i dowiesz się, jak można ich używać do tworzenia kart.
  • Proces tworzenia karty w Portfelu Google: ten artykuł zawiera kompleksowe omówienie wszystkich czynności, które należy wykonać, aby utworzyć kartę za pomocą interfejsu Google Wallet API.

Narzędzia i zasoby

  • Ćwiczenia z programowania

    Dzięki samodzielnemu ćwiczeniu z programowania dowiesz się, jak dodać kartę do Portfela Google. Na początek wybierz „Android”, jeśli implementacja ma być dostępna tylko na urządzeniach z Androidem. Jeśli Twoja implementacja obsługuje Androida, internet, e-maila lub SMS-a, wybierz „Internet”.

    Android Sieć

  • Kreator kart

    Za pomocą narzędzia do tworzenia kart utwórz wizualnie pierwszą kartę i automatycznie wygeneruj plik JSON, którego potrzebujesz do utworzenia karty za pomocą interfejsu Google Wallet API.

  • GitHub w Portfelu Google

    Na stronie GitHub w Portfelu Google znajdziesz przydatne narzędzia, biblioteki i przykładowy kod do różnych języków programowania.