一般票證總覽
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
其他預先定義的票證類型不符合用途時，即可使用一般票證。與其他票證 (例如票券、會員卡和優惠) 專屬的欄位和功能不同，一般票證會提供可定義自訂標籤和值的欄位，藉此支援多種用途。
範例用途
以下列舉幾種一般傳遞類型的用途：
- 停車證
- 借書證
- 會員卡
- 保險卡
- 訂位確認
- 客戶的預先螢幕確認代碼
在某些情況下，您的票證或用途可能會涉及機密資訊，例如個人識別資訊 (PII) 和健康資料。在這類情況下，「一般私人證件」類型適用於已預先核准的用途。詳情請參閱一般私人證件說明文件和使用限制政策 (AUP)。
您可以透過 Google Wallet API，為使用者核發票證，以便儲存在多個平台 (包括 Android 應用程式) 和任何支援超連結的地方，例如網站、電子郵件和簡訊。
API 與 SDK
Google Wallet API 提供 REST API 和 Android SDK，能協助您輕鬆快速地核發及管理票證。
注意：透過 Google Wallet API 核發票證不需要使用 Google Wallet REST API 或 Google Wallet Android SDK，但強烈建議使用。如要進一步瞭解如何在不使用 REST API 或 Android SDK 的情況下核發票證，請參閱在 JWT 中建立票證物件和票證類別一文。
需求條件
如要透過 Google Wallet API 核發票證，請先按照下列步驟操作：
開始使用 Google Wallet API
開始使用 Google Wallet API 前，請先參閱下列實用文章，瞭解基本功能和術語。
- 重要概念和術語：本文可協助您熟悉使用 Google Wallet API 所需的所有重要詞彙和功能。
- 票證類別和物件總覽：您必須將票證類別與票證物件結合，藉此建立您核發給使用者的票證。本文將介紹這兩個概念，並說明如何運用這些概念建立票證。
- Google 錢包票證開發流程：本文提供從頭到尾使用 Google Wallet API 建立票證的所有必要步驟。
- 程式碼研究室
自助程式碼研究室會逐步引導您完成新增票證至 Google 錢包的必要步驟。首先，如果您的實作項目僅適用於 Android 裝置，請選擇「Android」；如果您的實作項目支援 Android、網頁、電子郵件或簡訊，請選擇「網路」。
Android
網頁
- 票證建構工具
使用票證製作工具以視覺化方式建立第一張票證，然後透過 Google Wallet API 自動產生建立票證時所需的 JSON。
- Google 錢包 GitHub
前往 Google 錢包 GitHub 機構取得各種程式設計語言的實用工具、程式庫和程式碼範例。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[[["\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)."]]
