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 Configura tu app para obtener pasos detallados.
El flujo de la API de Picker
A continuación, se muestra 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 si hay 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 haciendo una llamada a la API de Picker para crear una sesión nueva. Esta llamada mostrará un
pickerUri
único.Dirige a los usuarios a la app de Google Fotos: Proporciona el
pickerUri
a los 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 su app de Google Fotos.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.
Consulta la sesión: Tu app debe consultar la sesión periódicamente para verificar el estado. Debes buscar que la propiedad
mediaItemsSet
muestre el valor verdadero, lo que indica que el usuario terminó su selección.Lista de elementos multimedia seleccionados: Una vez que
mediaItemsSet
devuelve un valor verdadero, puedes usar el método de lista para obtener detalles sobre los elementos multimedia seleccionados.Recuperar y usar elementos multimedia: Ahora tienes acceso a los elementos multimedia seleccionados. Puedes recuperar su contenido con
baseUrl
y usarlo 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 nuestro ejemplo para ver la API de Picker en acción y obtener inspiración para tu integración.