La API de Picker proporciona una forma segura para que los usuarios seleccionen fotos y videos de su biblioteca de Google Fotos y los compartan con tu aplicación.
Antes de comenzar
- Consulta la descripción general: Compara la API de Picker y la API de Library para asegurarte de que la API de Picker sea la adecuada para tu caso de uso.
- Configura tu app: Habilita la API y configura la autenticación. Consulta Cómo configurar tu app para conocer los pasos detallados.
Flujo de la API de Picker
A continuación, se incluye una descripción general de cómo funciona la API de Picker:
Verifica el token de OAuth: Antes de iniciar el flujo de la API de Picker, verifica que haya un token de acceso de OAuth 2.0 válido para el usuario. Si no hay un token, inicia el flujo de autorización de OAuth 2.0 para obtener uno.
Crea una sesión: Inicia el proceso con una llamada a la API de Picker para crear una sesión nueva. Esta llamada devolverá un
pickerUri
único.Dirige a los usuarios a la app de Google Fotos: Proporciona el
pickerUri
a tus usuarios (ya sea como un vínculo en el que se puede hacer clic o un código QR). Esta URL abrirá de forma segura la app de Google Fotos. En el caso de las aplicaciones basadas en la Web, puedes agregar/autoclose
a este URI para cerrar automáticamente la ventana de Google Fotos después de que el usuario complete su selección.El usuario selecciona elementos multimedia: En la app de Google Fotos, los usuarios pueden explorar su biblioteca y seleccionar las fotos y los videos que quieren compartir con tu app. Lee una descripción general de la experiencia de selección del usuario.
Sondea la sesión: Tu app debe sondear la sesión periódicamente para verificar el estado. Buscas la propiedad
mediaItemsSet
para que devuelva verdadero, lo que indica que el usuario finalizó su selección.Enumera los elementos multimedia seleccionados: Una vez que
mediaItemsSet
devuelve verdadero, puedes usar el método de lista para obtener detalles sobre los elementos multimedia seleccionados.Recupera y usa elementos multimedia: Ahora tienes acceso a los elementos multimedia seleccionados. Puedes recuperar su contenido con
baseUrl
y utilizarlo en tu aplicación.
Próximos pasos
- Revisa la documentación de referencia: Explora la documentación de referencia detallada de la API de Picker para obtener información sobre todos los métodos y parámetros disponibles.
- Prueba las muestras: Consulta nuestra muestra para ver la API de Picker en acción y obtener inspiración para tu integración.