Tổng quan về thẻ và vé chung
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bạn có thể sử dụng Thẻ và vé chung khi trường hợp sử dụng của bạn không phù hợp với bất kỳ loại thẻ và vé được xác định trước nào khác. Không giống như các thẻ và vé khác bao gồm những trường và tính năng dành riêng cho một trường hợp sử dụng (chẳng hạn như vé, thẻ khách hàng thân thiết và ưu đãi), Thẻ chung được thiết kế để đủ linh hoạt để hỗ trợ nhiều mục đích bằng cách cung cấp những trường mà bạn có thể xác định các nhãn và giá trị tuỳ chỉnh.
Các trường hợp sử dụng mẫu
Sau đây chỉ là một vài ví dụ về những việc bạn có thể làm với loại thẻ và vé Chung:
- Thẻ đỗ xe
- Thẻ thư viện
- Thẻ thành viên
- Thẻ bảo hiểm
- Xác nhận yêu cầu đặt chỗ
- Mã xác nhận trước khi sàng lọc khách hàng
Có những trường hợp thẻ hoặc trường hợp sử dụng của bạn có thể liên quan đến thông tin nhạy cảm, chẳng hạn như thông tin nhận dạng cá nhân (PII) và dữ liệu sức khoẻ. Đối với các trường hợp này, loại thẻ và vé riêng tư chung có sẵn cho những trường hợp sử dụng đã được phê duyệt trước. Để biết thêm thông tin, hãy xem tài liệu Thẻ và vé riêng tư chung và Chính sách sử dụng (AUP).
Với Google Wallet API, bạn có thể cấp thẻ và vé cho người dùng để lưu vào Google Wallet trên nhiều nền tảng, bao gồm cả các ứng dụng Android, cũng như ở bất kỳ nơi nào có hỗ trợ siêu liên kết, chẳng hạn như trang web, email và tin nhắn SMS.
API và SDK
API Google Wallet cung cấp API REST và SDK Android để giúp bạn cấp và quản lý thẻ và vé một cách nhanh chóng và dễ dàng.
- API REST của Google Wallet
Để phát hành thẻ và vé trên các nền tảng như Web, email hoặc SMS, bạn nên sử dụng API REST của Google Wallet. API này cung cấp một tập hợp các điểm cuối cho phép bạn tạo, truy xuất và cập nhật nhiều thành phần của thẻ và vé.
- SDK Google Wallet dành cho Android
Để phát hành thẻ và vé trong ứng dụng Android, bạn nên sử dụng SDK Google Wallet dành cho Android. SDK cung cấp nhiều phương pháp tiện lợi giúp dễ dàng tích hợp API Google Wallet vào ứng dụng dành cho thiết bị di động bằng mã gốc.
Lưu ý: Bạn không bắt buộc phải sử dụng API REST của Google Wallet hoặc SDK Android của Google Wallet để cấp thẻ và vé bằng API Google Wallet, nhưng bạn nên làm vậy. Để biết thêm thông tin về việc cấp thẻ và vé mà không cần sử dụng API REST hoặc SDK Android, hãy xem phần Tạo đối tượng thẻ và vé trong JWT.
Yêu cầu
Để cấp thẻ và vé bằng API Google Wallet, trước tiên, bạn cần làm như sau:
Bắt đầu sử dụng Google Wallet API
Trước khi bạn bắt đầu làm việc với API Google Wallet, hãy xem các bài viết hữu ích sau để làm quen với các tính năng và thuật ngữ cơ bản.
- Các khái niệm và thuật ngữ chính: Bài viết này sẽ giúp bạn làm quen với tất cả các thuật ngữ và tính năng quan trọng mà bạn sẽ cần để làm việc với Google Wallet API.
- Tổng quan về đối tượng và lớp thẻ và vé: Các thẻ và vé mà bạn cấp cho người dùng được tạo bằng cách kết hợp một lớp thẻ và vé với một đối tượng thẻ/vé. Bài viết này sẽ giúp bạn hiểu rõ cả hai khái niệm này và cách sử dụng chúng để tạo thẻ và vé.
- Quy trình phát triển thẻ và vé của Google Wallet: Bài viết này cung cấp thông tin tổng quan toàn diện về tất cả các bước cần thực hiện để tạo thẻ và vé bằng API Google Wallet từ đầu đến cuối.
- Lớp học lập trình
Các lớp học lập trình tự hướng dẫn sẽ hướng dẫn bạn các bước cần thiết để thêm thẻ và vé vào Google Wallet. Để bắt đầu, hãy chọn "Android" nếu quá trình triển khai của bạn chỉ diễn ra trên thiết bị Android và chọn "Web" nếu quá trình triển khai của bạn hỗ trợ Android, Web, Email hoặc SMS.
Android
Web
- Trình tạo thẻ và vé
Tạo thẻ và vé đầu tiên theo cách trực quan bằng công cụ trình tạo thẻ và vé và tự động tạo JSON mà bạn cần để tạo thẻ và vé bằng API Google Wallet.
- GitHub của Google Wallet
Nhận các công cụ, thư viện và mã mẫu hữu ích cho nhiều ngôn ngữ lập trình trong tổ chức GitHub của Google Wallet.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
