Primeros pasos
¿Qué es la API de la Billetera de Google?
La API de la Billetera de Google permite a los desarrolladores crear pases digitales en la Billetera de Google. Actualmente, la API de la Billetera de Google admite tarjetas de embarque, entradas para eventos, tarjetas de lealtad, ofertas y pases de transporte público. Recientemente, se agregó un tipo de pase genérico para admitir casos de uso adicionales.
¿Cómo puedo configurar mi entorno para desarrolladores según los requisitos y la complejidad de mi empresa?
A continuación, se incluyen guías que pueden utilizarse para configurar un entorno de desarrollo que satisfaga los diferentes niveles de seguridad y complejidad empresarial. El uso de varias cuentas de servicio puede permitir que los desarrolladores creen un entorno TEST independiente de su entorno PROD.
Complejidad de la configuración básica
1 cuenta de Business Console o 1 cuenta principal de Business Console para muchas cuentas de entidad emisora.
- Esta opción habilita un enfoque administrado de forma centralizada mediante el uso de 1 cuenta principal con ninguna o muchas subempresas o entidades emisoras.
- 1 proyecto de Google Cloud.
- 1 credencial de cuenta de servicio.
- Conjunto único de usuarios
Complejidad de configuración promedio
1 cuenta principal a muchas cuentas de entidad emisora.
- Esta opción habilita un enfoque administrado centralmente mediante 1 cuenta principal con muchas subempresas.
- 1 proyecto de Google Cloud.
- Usuarios de Business Console distintos por entidad emisora.
- 1 a muchas credenciales de cuenta de servicio.
- 1 credencial por empresa o entidad emisora.
- Diferente acceso a credenciales por empresa.
Complejidad de configuración compleja
1 cuenta principal a muchas cuentas de entidad emisora.
- Esta opción habilita un enfoque administrado centralmente mediante 1 cuenta principal con muchas subempresas.
- 1 a muchos proyectos de Google Cloud.
- Usuarios de Business Console distintos por entidad emisora.
- 1 a muchas credenciales de cuenta de servicio.
- 1 credencial de PROD por empresa o entidad emisora.
- 1 credencial de DEV por empresa o entidad emisora.
Comunicarse con el servicio de asistencia
Trabaja con pases
¿Cómo borro objetos o clases?
Por el momento, no puedes borrar objetos ni clases de la Billetera de Google. Sin embargo, los usuarios pueden desvincular objetos de su Billetera de Google.
¿Cómo agrego varios pases?
Usar GroupingID facilita la agrupación de pases.
¿Cómo actualizo solo una parte de un pase?
Sigue nuestra guía de rendimiento para comprender cómo realizar actualizaciones parciales mediante solicitudes PATCH.
¿Puedo crear pases por lotes?
Sigue nuestra guía de rendimiento para comprender cómo realizar solicitudes por lotes con la API.
Preguntas generales
¿Cuál es el límite de frecuencia de las solicitudes que se envían a la API de la Billetera de Google?
Las llamadas a la API de la Billetera de Google tienen un límite de frecuencia de 20 solicitudes por segundo.
¿Qué códigos de error devuelve la API de la Billetera de Google?
Para ver una lista de los códigos de error y las excepciones que muestra la API de la Billetera de Google, consulta Códigos de error.¿Cómo habilito las notificaciones push?
Por el momento, la Billetera de Google no admite las notificaciones push creadas por el desarrollador. Sin embargo, la Billetera de Google envía notificaciones oportunas de los siguientes pases. Por el momento, la Billetera de Google no admite las notificaciones push creadas por el desarrollador.
| Vertical | Notificación | Activado | Documentación |
|---|---|---|---|
| Evento | Próximo recordatorio | 3 horas antes del evento | docs |
| Tarjeta de embarque | Próximo recordatorio | 3 horas antes de la salida del vuelo | docs |
| Tarjeta de embarque | Actualización de pases | Cambio de la terminal de origen, la puerta, la hora de embarque o la de salida | docs |
| Tarjeta de oferta | Recordatorio de vencimiento | 48 horas antes de que venza la tarjeta de la oferta | docs |
| Genérico | Próximo recordatorio | 24 horas antes de que comience el "intervalo de tiempo" | docs |
| Genérico | Recordatorio de vencimiento | 48 horas antes de que finalice el "tiempo interno" | docs |
¿Se pueden borrar los IDs del comerciante?
Actualmente, los IDs del comerciante no se pueden borrar ni archivar desde la Consola de Google Pay y la Billetera de Google.
¿Cómo utilizo la función App Linking?
La vinculación de apps requiere una lista de entidades permitidas, que puedes solicitar aquí.
¿La Billetera de Google es compatible con el geovallado?
Por el momento, no se admite el geovallado.
¿Cómo configuro un programa de lealtad?
Puedes configurar una inscripción y un programa de lealtad. Para ello, sigue esta guía.
¿Cómo puedo enviar a Google mi logotipo para los pases de transporte público?
Utiliza este formulario para enviar a Google el logotipo y agregarlo a la lista de entidades permitidas.
¿Cómo se manejan correctamente los datos de userProfile codificados en Base64?
Asegúrate de utilizar la codificación UTF-8 en todo el proceso. Primero, la cadena JSON se codifica en formato UTF-8 y, luego, se usa android.util.Base64 con las opciones NO_WRAP y URL_SAFE. Esto corresponde a la sección 4 de RFC 3548.
¿Cómo creo cuentas de entidad emisora de manera programática?
Consulta esta guía para crear cuentas de entidad emisora a través de la API.
Toque inteligente
¿Necesito un lector de NFC especial para los pases de Google SmartTap?
Debe ser una terminal compatible con SmartTap. Puedes encontrar una lista de proveedores certificados aquí.
¿Cómo hago que mis pases funcionen con NFC?
Sigue esta configuración para permitir que tu pase se pueda canjear con el toque inteligente.
Tokens web JSON (JWT)
¿Existen herramientas que simplifiquen la implementación y depuración de los JWT?
Sí, las plataformas como www.jwt.io te permiten decodificar y depurar tus tokens durante el proceso de desarrollo, lo que te permite verificar el contenido que envías. Tenga en cuenta que Google no tiene ninguna afiliación y no recomienda específicamente ninguno de estos terceros.
La URL de mi vínculo de JWT supera la restricción del navegador que tiene el límite de 1800 caracteres. ¿Qué debo hacer?
Puedes crear clases y objetos previamente con la API antes de crear el vínculo para guardar pases (JWT).
Solución de problemas
¿Por qué mi configuración de horario muestra una hora incorrecta para el evento?
La hora que se muestra en el pase es la hora local del evento, con compensación para la hora en la que se realiza el evento.
Mi logotipo no se renderizará en los pases que compilé. ¿Qué podría estar mal?
- Primero, asegúrate de que tu logotipo siga los lineamientos y esté guardado en formato PNG.
- Asegurarse de que el logotipo esté disponible con alta confiabilidad No los redirecciones a archivos de imagen que puedan causar errores 404. Tus imágenes deben estar alojadas en una ubicación HTTPS, ya que, de lo contrario, no aparecerán en la Billetera de Google.
- Asegúrate de que todos los campos obligatorios marcados como obligatorios en la API estén configurados en el pase.
Asistencia y comentarios
¿Cómo puedo comunicarme con el equipo de asistencia técnica?
Si necesitas más ayuda, comunícate con el equipo de asistencia al cliente haciendo clic en el botón “Comunicarse con el equipo de asistencia” en la barra lateral izquierda de la consola de Google Pay y la Billetera.
¿Cómo puedo enviar comentarios sobre el producto?
Para enviar comentarios sobre el producto, haz clic en el botón “Enviar comentarios” que se encuentra en el cuadrante superior derecho de la página del sitio para desarrolladores y selecciona “Comentarios sobre el producto”. A continuación, describe tus comentarios en el área de texto y haz clic en "Enviar".
¿Cómo puedo enviar comentarios sobre la documentación?
Para enviar comentarios sobre la documentación, haz clic en el botón "Enviar comentarios" en el cuadrante superior derecho de la página del sitio para desarrolladores y selecciona "Comentarios sobre la documentación". A continuación, describe tus comentarios en el área de texto y haz clic en "Enviar".