La API de la Biblioteca te permite interactuar con fotos, videos y álbumes dentro de las bibliotecas de Google Fotos de los usuarios, pero con un enfoque importante: solo puedes acceder al contenido creado por tu aplicación y administrarlo.
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 Library 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.
Casos de uso clave de la API de Library
La API de Library es ideal para situaciones en las que tu app necesita hacer lo siguiente:
- Sube y almacena contenido multimedia: Importa fotos y videos (generados por tu app) de forma segura a las bibliotecas de Google Fotos de tus usuarios.
- Organiza el contenido: Crea y administra álbumes para ayudar a los usuarios a organizar su contenido multimedia relacionado con la app.
- Mejora fotos y álbumes: Agrega contexto a los elementos multimedia y los álbumes mediante mejoras como los títulos, las descripciones o la información de la ubicación.
- Accede a los datos creados por la app: Recupera e interactúa con las fotos, los videos y los álbumes que tu app creó anteriormente.
Flujo de trabajo típico de la API de la biblioteca
Si bien la API de la Biblioteca ofrece varias funcionalidades, un flujo de trabajo común podría incluir los siguientes pasos:
Sube contenido multimedia: Usa el extremo de cargas para subir bytes de fotos o videos de forma segura a Google Fotos. En este paso, se genera un
uploadToken.Crea elementos multimedia: Usa el método
mediaItems.batchCreatey proporciona eluploadTokenpara crear elementos multimedia en la biblioteca del usuario.Crea álbumes (opcional): Usa el método
albums.createpara crear álbumes en la biblioteca del usuario y organizar los elementos multimedia.Administrar álbumes:
- Agrega elementos multimedia (creados por tu app) a los álbumes con
albums.batchAddMediaItems. - Quita elementos multimedia de los álbumes con
albums.batchRemoveMediaItems. - Agrega enriquecimientos a los álbumes (como títulos o ubicaciones) con
albums.addEnrichment. - Recupera información sobre álbumes específicos con
albums.get. - Enumera los álbumes creados por tu app con
albums.list.
- Agrega elementos multimedia (creados por tu app) a los álbumes con
Accede al contenido multimedia creado por la app:
- Recupera detalles sobre elementos multimedia específicos con
mediaItems.getomediaItems.batchGet. - Busca elementos multimedia creados por tu app con
mediaItems.search. - Enumera elementos multimedia dentro de un álbum específico creado por la app mediante
mediaItems.searchcon el ID del álbum.
- Recupera detalles sobre elementos multimedia específicos con
Próximos pasos
- Revisa la documentación de referencia: Explora la documentación de referencia detallada de la API de la biblioteca para obtener información sobre todos los métodos y parámetros disponibles.
- Prueba las muestras: Echa un vistazo a nuestro ejemplo para ver la API de la Biblioteca en acción y obtener inspiración para tu integración.