L'API Library vous permet d'interagir avec les photos, les vidéos et les albums dans les bibliothèques Google Photos de vos utilisateurs, mais avec un objectif important : vous ne pouvez accéder qu'aux contenus créés par votre application et les gérer.
Avant de commencer
- Consultez la présentation : Comparer l'API Picker et l'API Library pour vous assurer que l'API Library est adaptée à votre cas d'utilisation.
- Configurez votre application : activez l'API et configurez l'authentification. Pour connaître la procédure détaillée, consultez Configurer votre application.
Principaux cas d'utilisation de l'API Library
L'API Library est idéale pour les scénarios où votre application doit :
- Importer et stocker des contenus multimédias : importez de manière sécurisée des photos et des vidéos (générées par votre application) dans les bibliothèques Google Photos de vos utilisateurs.
- Organiser le contenu:créez et gérez des albums pour aider les utilisateurs à organiser les contenus multimédias liés à leur application.
- Améliorez vos photos et vos albums : ajoutez du contexte aux éléments multimédias et aux albums grâce à des enrichissements tels que des titres, des descriptions ou des informations de localisation.
- Accéder aux données créées par l'application:récupérez les photos, vidéos et albums précédemment créés par votre application, et interagissez avec eux.
Workflow type de l'API Library
Bien que l'API Library offre diverses fonctionnalités, un workflow courant peut impliquer les étapes suivantes:
Importer des contenus multimédias : utilisez le point de terminaison d'importation pour importer de manière sécurisée des octets de photos ou de vidéos dans Google Photos. Cette étape génère un
uploadToken
.Créer des éléments multimédias : utilisez la méthode
mediaItems.batchCreate
en fournissantuploadToken
pour créer des éléments multimédias dans la bibliothèque de l'utilisateur.Créer des albums (facultatif) : utilisez la méthode
albums.create
pour créer des albums dans la bibliothèque de l'utilisateur afin d'organiser les éléments multimédias.Gérer les albums:
- Ajoutez des éléments multimédias (créés par votre application) à des albums à l'aide de
albums.batchAddMediaItems
. - Supprimez des éléments multimédias d'un album à l'aide de
albums.batchRemoveMediaItems
. - Ajoutez des éléments à des albums (par exemple, des titres ou des lieux) à l'aide de
albums.addEnrichment
. - Récupérez des informations sur des albums spécifiques à l'aide de
albums.get
. - Répertorier les albums créés par votre application à l'aide de
albums.list
- Ajoutez des éléments multimédias (créés par votre application) à des albums à l'aide de
Accès aux contenus multimédias créés par l'application :
- Récupérez les détails d'éléments multimédias spécifiques à l'aide de
mediaItems.get
oumediaItems.batchGet
. - Recherchez les éléments multimédias créés par votre application à l'aide de
mediaItems.search
. - Répertoriez les éléments multimédias d'un album créé par une application spécifique à l'aide de
mediaItems.search
avec l'ID de l'album.
- Récupérez les détails d'éléments multimédias spécifiques à l'aide de
Étapes suivantes
- Consultez la documentation de référence : explorez la documentation de référence de l'API de la bibliothèque pour en savoir plus sur toutes les méthodes et tous les paramètres disponibles.
- Essayez les exemples : consultez notre exemple pour voir l'API Library en action et trouver l'inspiration pour votre intégration.