Ogólne omówienie karty
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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
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.
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.
- Ć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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[[["\u003cp\u003eThe Generic Pass is a versatile pass type in Google Wallet, suitable for various use cases beyond standard tickets or loyalty cards, allowing custom data through defined labels and values.\u003c/p\u003e\n"],["\u003cp\u003eSensitive information like PII should be handled using the Generic Private pass type, with pre-approval needed for specific use cases.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Wallet API enables pass creation and management across Android, web, and messaging platforms through REST API and Android SDK.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need a Google Wallet API Issuer Account, along with a Google Cloud Account (non-Android) or Google Play Services setup (Android).\u003c/p\u003e\n"],["\u003cp\u003eGoogle offers resources like codelabs, a pass builder tool, and GitHub repositories to help developers integrate and utilize the Google Wallet API effectively.\u003c/p\u003e\n"]]],["The Generic Pass in Google Wallet supports diverse purposes with custom labels and values, such as parking, library, or membership cards. For sensitive data, there's a Generic Private pass option. Passes can be issued across platforms, using the REST API for web, email, or SMS, and the Android SDK for Android apps. Issuers need a Google Wallet API account; non-Android developers also need a Google Cloud account. Key resources include codelabs, a pass builder, and the Google Wallet GitHub.\n"],null,["# Generic Pass overview\n\nThe Generic Pass is available for when your use case doesn't fit into any of the\nother predefined pass types. Unlike other passes that include fields and features\nthat are specific to a use case, such as tickets, loyalty cards, and offers, the\nGeneric Pass is intended to be flexible enough to support a variety of purposes\nby providing fields where you can define custom labels and values.\n\nExample use cases\n-----------------\n\nThe following are just a few examples of what you can do with the Generic pass\ntype:\n\n- Parking passes\n- Library cards\n- Membership cards\n- Insurance cards\n- Reservation confirmations\n- Customer pre-screen confirmation codes\n\nPasses that include sensitive information\n-----------------------------------------\n\nThere are cases where your pass or use case may involve sensitive information,\nsuch as personally identifiable information (PII) and health data. For these\nscenarios, the Generic Private pass type is available for pre-approved use\ncases. For more information, see the [Generic Private Pass documentation](/wallet/generic-private-pass)\nand the [Acceptable Use Policy (AUP)](https://payments.developers.google.com/terms/aup#sensitive-data).\n\nSupported platforms\n-------------------\n\nWith the Google Wallet API, you can issue passes for your users to save in their Google Wallet across multiple platforms, including Android apps, and anywhere hyperlinks are supported, such as websites, email, and SMS messages.\n\n### APIs \\& SDKs\n\nThe Google Wallet API offers a REST API and an Android SDK to help you issue and manage your passes quickly and easily.\n\n- [Google Wallet REST API](/wallet/generic/web/prerequisites) \n\n To issue passes on platforms such as the Web, email, or SMS, we recommend you use the Google Wallet REST API. The API provides a set of endpoints that let you create, retrieve, and update the various components of passes.\n- [Google Wallet Android SDK](/wallet/generic/android/prerequisites) \n\n To issue passes in an Android app, we recommend you use the Google Wallet Android SDK. The SDK provides a variety of convenience methods that make it easy to integrate the Google Wallet API into your mobile apps using native code.\n\nNote: Using the Google Wallet REST API or Google Wallet Android SDK is not required to issue passes with the Google Wallet API, but are strongly recommended. For more information on issuing passes without using the REST API or Android SDK, see [Creating Passes Objects and Passes Classes in the JWT](https://developers.google.com/wallet/retail/offers/overview/add-to-google-wallet-flow#creating-passes-objects-and-passes-classes-in-the-jwt).\n\nRequirements\n------------\n\nTo issue passes with the Google Wallet API, you will first need to do the following:\n\n- Create a [Google Wallet API Issuer account](/wallet/generic/getting-started/issuer-onboarding).\n- Non-Android developers: Create a [Google Cloud account](https://console.cloud.google.com/freetrial).\n- Android developers: [Set up Google Play services.](/android/guides/setup)\n\nGetting started with the Google Wallet API\n------------------------------------------\n\nBefore you start working with the Google Wallet API, take a look at these useful articles that will familiarize you with the basic features and terminology.\n\n- [Key concepts and terminology](/wallet/generic/resources/terminology): This article will familiarize you with all the important terms and features you will need to work with the Google Wallet API.\n- [Passes Classes and Objects overview](/wallet/generic/overview/how-classes-objects-work): Passes that you issue to your users are created by combining a Passes Class with a Passes Objects. This article will familiarize you with both of these concepts, and how they are used to create passes.\n- [Google Wallet pass development flow](/wallet/generic/overview/add-to-google-wallet-flow): This article provides an end-to-end overview of all of the steps needed to create a pass with the Google Wallet API from start to finish.\n\n### Tools \\& resources\n\n- **Codelabs** \n\n\n Self-guided codelabs walk you through the necessary steps to add a pass\n to Google Wallet. To get started, choose \"Android\" if your implementation will be on Android devices\n only and choose \"Web\" if your implementation supports Android, Web, Email or SMS.\n\n\n [Android](https://g.co/wallet/android-codelab)\n [Web](https://g.co/wallet/web-codelab)\n- **Pass builder** \n\n Build your first pass visually with the [pass builder](/wallet/generic/resources/pass-builder) tool, and automatically generate the JSON you need to create the pass with the Google Wallet API.\n- **Google Wallet Github**\n\n Get helpful tools, libraries and sample code for a variety of programming languages in the [Google Wallet Github org](https://github.com/google-wallet)."]]
