Modifications apportées aux API Google Photos

Date de publication : septembre 2024

Cette page fournit des informations sur les modifications spécifiques apportées à Google Photos API. Consultez les détails de cette page pour comprendre comment les méthodes et les niveaux d'accès que vous utilisez peut être affecté. Pour en savoir plus sur l'annonce de ces modifications dans l'article de blog associé.

API Library: impact sur les cas d'utilisation courants

Les sections suivantes détaillent l'impact des modifications à venir sur les usages courants cas d'utilisation.

Importer des éléments multimédias et créer des albums

Ce qui change:aucun changement. Vous pouvez continuer à importer des éléments multimédias et à créer des albums à l'aide de la portée photoslibrary.appendonly.

Ce que vous pouvez faire:

Si votre application importe des éléments multimédias ou crée des albums, assurez-vous que votre le champ d'application photoslibrary.appendonly, et non photoslibrary. La photoslibrary habilitation est en cours de suppression.

Lister, rechercher et récupérer des éléments multimédias et des albums

Ce qui change:vous pouvez désormais uniquement répertorier, rechercher et récupérer les albums et éléments multimédias créés par votre application.

Ce que vous pouvez faire:

• Si votre application nécessite que les utilisateurs sélectionnent des photos ou des albums dans leur bibliothèque, utilisez le nouveau sélecteur Google Photos API. Cela permet de sécuriser qui permet aux utilisateurs d'accorder l'accès à un contenu spécifique.
• Si votre application nécessite d'accéder à l'intégralité de la bibliothèque de l'utilisateur, vous devrez peut-être réévaluez votre application ou envisagez d'autres approches.

Partage et albums partagés

Ce qui change:les albums partagés et les fonctions d'API associées (partager, "unshare", "get", "join", "leave" et "list") renvoie un 403 PERMISSION_DENIED après 31 mars 2025.

Ce que vous pouvez faire:

Redirigez les utilisateurs vers l'application Google Photos pour qu'ils gèrent eux-mêmes le partage. Vous pouvez fournir des instructions claires ou des liens profonds dans votre application pour les guider.

Gérer les albums créés par une application: options d'enrichissement et contenu des albums

Ce qui change:photoslibrary.edit.appcreatedata est ajouté à les trois méthodes suivantes pour la cohérence conceptuelle:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

Ce que vous pouvez faire:

• Si votre application utilise déjà ces méthodes, envisagez d'adopter les photoslibrary.edit.appcreatedata habilitation pour simplifier votre autorisation processus.

API de la bibliothèque : portées et méthodes concernées

Dans le cadre des modifications apportées aux API Google Photos, nous avons apporté les modifications suivantes : mises à jour.

Comme indiqué sur la page Autorisation , les champs d'application suivants seront supprimées de l'API Library après le 31 mars 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Les champs d'application suivants seront conservés:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

Ce tableau détaille les méthodes et les portées spécifiques de l'API Library concernées.

Mises à jour	Méthodes	Niveaux d'accès
Ces méthodes ne peuvent désormais être utilisées qu'avec des albums et des éléments multimédias créés par votre application. Cela inclut les éléments multimédias sélectionnés avec l'API Picker et ajoutés à la bibliothèque de l'utilisateur avec l'API Library.	albums.create mediaItems.batchCreate	Champs d'application restants: photoslibrary.appendonly Champs d'application supprimés: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Champs d'application restants: photoslibrary.readonly.appcreatedata Champs d'application supprimés: photoslibrary photoslibrary.readonly
Ces méthodes ne seront plus disponibles.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Champs d'application restants: Aucun Champs d'application supprimés: photoslibrary.sharing
La photoslibrary.edit.appcreatedata sera ajoutée à ces méthodes. Vous ne pouvez utiliser ces méthodes qu'avec les albums et les éléments multimédias créés par votre application. Cela inclut les éléments multimédias sélectionnés avec l'API Picker et ajoutés à la bibliothèque de l'utilisateur avec l'API Library.	albums.addEnrichment albums.batchAddMediaItems	Champs d'application restants: photoslibrary.appendonly photoslibrary.edit.appcreatedata Champs d'application supprimés: photoslibrary
	albums.batchRemoveMediaItems	Champs d'application restants: photoslibrary.edit.appcreatedata Champs d'application supprimés : photoslibrary
Ces méthodes ne changeront pas.	albums.patch mediaItems.patch	Champ d'application restant : photoslibrary.edit.appcreatedata Champs d'application supprimés : Aucun

Mise à jour du règlement de l'API Photos

La Politique d'utilisation autorisée actuelle sera remplacé après le 31 mars 2025 par les nouvelles données utilisateur et développeur de l'API Photos Règlement. La nouvelle règle est d'ores et déjà disponible pour un aperçu.

Modifications apportées à la documentation de l'API Photos

Nous avons apporté d'importantes modifications à la documentation de l'API Photos afin de refléter mises à jour à venir et qui facilitent le développement:

• Site des API Photos unifiée:nous avons regroupé toutes les ressources de l'API Photos en un seul et même endroit pratique (ce site), offrant ainsi une pour les développeurs. Vous y trouverez les éléments suivants:
  • Ressources centralisées:ensemble des instructions de configuration et des informations générales des conseils d'utilisation, et combine l'assistance et le règlement pour à la fois l'API Picker et l'API Library.
  • Sites d'API dédiés:sites individuels avec des guides détaillés, documentation de référence et exemples de code pour le sélecteur API et la bibliothèque API
• Mise à jour du contenu de l'API Library:la documentation de l'API Library a été révisée afin de refléter ses fonctionnalités après la période d'arrêt. Dans la documentation mise à jour, vous trouverez des libellés mettant en évidence Contenu modifié ou supprimé, avec des liens vers l'ancien contenu correspondant pour référence pendant la migration.
• Ancienne documentation préservée:nous avons conservé l'API Library d'origine d'assistance pour les développeurs vous n'avez pas besoin de migrer les intégrations existantes. Si vous démarrez un nouveau projet, utilisez la documentation mise à jour. Si lorsque vous mettez à jour un projet existant, reportez-vous aux anciens de la documentation selon les besoins.

Questions fréquentes

Qu'est-ce qui change dans les API Google Photos ?

Nous lançons la nouvelle API Google Photos Picker pour une sélection sécurisée des photos et mise à jour de l'API Library existante pour se concentrer sur la gestion des photos et des vidéos créés par votre application.

Quand ces modifications prendront-elles effet ?

Ces modifications prendront effet le 31 mars 2025. Nous encourageons toutes les personnes ayant intégrations existantes qui utilisent l'API Library pour la sélection de photos afin de migrer vers l'API Picker dès que possible.

Quel sera l'impact sur l'API Library ?

photoslibrary.readonly, photoslibrary.sharing et photoslibrary les niveaux d'accès seront supprimés. Les appels d'API ne reposant que sur ces champs d'application renvoient un 403 PERMISSION_DENIED. Plusieurs autres appels ne fonctionneront qu'avec les photos et vidéos créées par votre application.

Vous pouvez consulter l'ensemble des modifications dans le tableau en haut de cette page.

Que dois-je faire si mon application utilise actuellement les méthodes ou champs d'application concernés ?

Si votre application utilise l'une des méthodes ou des champs d'application concernés, nous vous recommandons de suivre procédez comme suit:

• Pour sélectionner des photos: migrez vers l'API Google Photos Picker.
• Pour les autres fonctionnalités : consultez la documentation mise à jour de l'API Library pour comprendre les modifications et identifier les fonctionnalités de votre application qui ne sont peut-être plus disponibles. Vous devrez peut-être ajuster les fonctionnalités de votre application ou explorer d'autres solutions pour certains cas d'utilisation.

Qu'est-ce que l'API Google Photos Picker ?

L'API Picker est un nouvel outil sécurisé permettant aux développeurs d'autoriser les utilisateurs à sélectionner des photos. et des albums de sa bibliothèque Google Photos, et les renvoyer facilement votre application. L'API Picker offre des fonctionnalités puissantes de sélection de photos, par exemple en sélectionnant des éléments individuels, tous les éléments d'un album et en effectuant une recherche dans la bibliothèque Google Photos.

Où puis-je trouver des informations supplémentaires sur ces modifications ?

La page que vous consultez actuellement présente un aperçu et un récapitulatif de toutes les modifications.

Le reste de la documentation sur notre site a été mis à jour pour refléter les API mises à jour.

Cet article de blog annonçant les changements.

Que faire si j'ai d'autres questions ou si j'ai besoin d'aide pour migrer mon application ?

Si vous avez des questions sur la documentation destinée aux développeurs, consultez notre assistance pour savoir comment obtenir de l'aide.