Premiers pas avec l'API Library

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

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:

  1. 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.

  2. Créer des éléments multimédias : utilisez la méthode mediaItems.batchCreate en fournissant uploadToken pour créer des éléments multimédias dans la bibliothèque de l'utilisateur.

  3. 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.

  4. 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
  5. 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 ou mediaItems.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.

É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.