El pase genérico está disponible cuando tu caso de uso no se adapta a ninguno de los otros tipos de pases predefinidos. A diferencia de otros pases que incluyen campos y funciones específicos para un caso de uso, como entradas, tarjetas de lealtad y ofertas, el pase genérico está diseñado para ser lo suficientemente flexible como para admitir una variedad de propósitos, ya que proporciona campos en los que puedes definir etiquetas y valores personalizados.
Casos prácticos de ejemplo
A continuación, se muestran algunos ejemplos de lo que puedes hacer con el tipo de pase genérico:
- Pases de estacionamiento
- Tarjetas de biblioteca
- Tarjetas de membresía
- Tarjetas de seguros
- Confirmaciones de reservas
- Códigos de confirmación previos a la pantalla del cliente
Pases que incluyan información sensible
Hay casos en los que tu pase o caso de uso podrían incluir información sensible, como información de identificación personal (PII) y datos de salud. En estas situaciones, el tipo de pase privado genérico está disponible para casos de uso aprobados con anterioridad. Para obtener más información, consulta la documentación genérica del pase privado y la Política de Uso Aceptable (AUP).
Plataformas compatibles
Con la API de la Billetera de Google, puedes emitir pases para que los usuarios los guarden en la Billetera de Google en múltiples plataformas, incluidas las apps para Android, y en cualquier lugar donde se admitan hipervínculos, como sitios web, correos electrónicos y mensajes SMS.
APIs y SDKs
La API de la Billetera de Google ofrece una API de REST y un SDK de Android para ayudarte a emitir y administrar tus pases de forma rápida y sencilla.
- API de REST de la Billetera de Google
Para emitir pases en plataformas como la Web, el correo electrónico o los SMS, te recomendamos que uses la API de REST de la Billetera de Google. La API proporciona un conjunto de extremos que te permiten crear, recuperar y actualizar los diversos componentes de los pases.
- SDK de Android de la Billetera de Google
Si quieres emitir pases en una app para Android, te recomendamos que uses el SDK de Android de la Billetera de Google. El SDK ofrece una variedad de métodos convenientes que facilitan la integración de la API de la Billetera de Google en tus apps para dispositivos móviles mediante código nativo.
Nota: No es obligatorio usar la API de REST de la Billetera de Google ni el SDK de la Billetera de Google para Android para emitir pases con la API de la Billetera de Google, pero es muy recomendable. Para obtener más información sobre cómo emitir pases sin usar la API de REST o el SDK de Android, consulta Crea objetos de pases y clases de pases en el JWT.
Requisitos
Para emitir pases con la API de la Billetera de Google, primero debes hacer lo siguiente:- Crea una cuenta de la entidad emisora de la API de la Billetera de Google.
- Si eres desarrollador que no usa Android, crea una cuenta de Google Cloud.
- Desarrolladores de Android: Cómo configurar los Servicios de Google Play
Cómo comenzar a usar la API de la Billetera de Google
Antes de comenzar a trabajar con la API de la Billetera de Google, consulta estos artículos útiles que te ayudarán a familiarizarte con la terminología y las funciones básicas.- Terminología y conceptos clave: En este artículo, conocerás los términos y las funciones importantes que necesitarás para trabajar con la API de la Billetera de Google.
- Descripción general de pases clases y objetos: Los pases que emites a tus usuarios se crean combinando una clase Passes con objetos Passes. En este artículo, te familiarizarás con estos dos conceptos y cómo se usan para crear pases.
- Flujo de desarrollo del pase de la Billetera de Google: En este artículo, se proporciona una descripción general de todos los pasos necesarios para crear un pase con la API de la Billetera de Google de principio a fin.
Herramientas y recursos
- Codelabs
En los codelabs autoguiados, se te indicarán los pasos necesarios para agregar un pase a la Billetera de Google. Para comenzar, elige "Android" si tu implementación será solo para dispositivos Android, y elige "Web" si tu implementación admite Android, Web, correo electrónico o SMS.
- Creador de pases
Crea tu primer pase de forma visual con la herramienta creador de pases y genera automáticamente el archivo JSON que necesitas para crearlo con la API de la Billetera de Google.
- GitHub de la Billetera de Google
Obtén herramientas, bibliotecas y código de muestra útiles para una variedad de lenguajes de programación en la organización de GitHub de la Billetera de Google.