Publié en septembre 2024.
Cette page fournit des informations sur les modifications spécifiques apportées aux API Google Photos. Consultez les informations de cette page pour comprendre l'impact potentiel sur les méthodes et les champs d'application que vous utilisez. Pour en savoir plus sur l'annonce de ces modifications, consultez cet article de blog.
API de bibliothèque: impact sur les cas d'utilisation courants
Les sections suivantes décrivent en détail l'impact des modifications à venir sur les cas d'utilisation courants.
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.
Que pouvez-vous faire ?
Si votre application importe des éléments multimédias ou crée des albums, assurez-vous d'utiliser le champ d'application photoslibrary.appendonly et non le champ d'application photoslibrary. Le champ d'application photoslibrary est en cours de suppression.
Lister, rechercher et récupérer des éléments multimédias et des albums
Changements:vous ne pouvez désormais lister, rechercher et récupérer que les albums et les éléments multimédias créés par votre application.
Que pouvez-vous faire ?
- Si votre application nécessite que les utilisateurs sélectionnent des photos ou des albums dans l'ensemble de leur bibliothèque, utilisez la nouvelle API Google Photos Picker. Cela permet aux utilisateurs d'accorder un accès à des contenus spécifiques de manière sécurisée et conviviale.
- Si votre application repose sur l'accès à l'intégralité de la bibliothèque de l'utilisateur, vous devrez peut-être réévaluer votre application ou envisager d'autres approches.
Partage et albums partagés
Changements:les albums partagés et les fonctions d'API associées (partager, annuler le partage, obtenir, rejoindre, quitter et lister) renverront un 403 PERMISSION_DENIED après le 31 mars 2025.
Que pouvez-vous faire ?
Diriger les utilisateurs vers l'application Google Photos pour qu'ils gèrent eux-mêmes le partage Vous pouvez leur fournir des instructions claires ou des liens profonds dans votre application pour les guider.
Gérer les albums créés par l'application: enrichissements et contenus des albums
Changements:photoslibrary.edit.appcreateddata est ajouté aux trois méthodes suivantes pour assurer la cohérence conceptuelle:
albums.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
Que pouvez-vous faire ?
- Si votre application utilise déjà ces méthodes, envisagez d'adopter le champ d'application
photoslibrary.edit.appcreateddatapour simplifier votre processus d'autorisation.
API de la bibliothèque: portées et méthodes concernées
Dans le cadre de nos modifications apportées aux API Google Photos, nous avons effectué les mises à jour suivantes.
Comme indiqué sur la page d'autorisation mise à jour, les champs d'application suivants seront supprimés de l'API Library après le 31 mars 2025:
photoslibrary.readonlyphotoslibrary.sharingphotoslibrary
Les champs d'application suivants resteront disponibles:
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.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 les albums et les éléments multimédias créés par votre application. | Champ d'application restant :
|
|
Champ d'application restant :
|
||
| Ces méthodes ne seront plus disponibles. | Champ d'application restant :
|
|
La photoslibrary.edit.appcreateddata sera ajoutée à ces méthodes. Ces méthodes ne peuvent désormais être utilisées qu'avec les albums et les éléments multimédias créés par votre application. |
Champ d'application restant :
|
|
Champ d'application restant :
|
||
| Ces méthodes ne changeront pas. | Champ d'application restant :
|
Mises à jour du règlement de l'API Photos
Après le 31 mars 2025, le Règlement sur l'utilisation autorisée actuel sera remplacé par le nouveau Règlement pour les développeurs et les données utilisateur de l'API Photos. La nouvelle règle est désormais disponible en version Preview.
Mises à jour de la documentation de l'API Photos
Nous avons apporté des modifications importantes à la documentation de l'API Photos pour refléter les mises à jour à venir et faciliter votre expérience de développement:
- Site unifié des API Photos:nous avons regroupé toutes les ressources de l'API Photos en un seul endroit (ce site), ce qui offre une expérience simplifiée aux développeurs. Vous y trouverez les éléments suivants :
- Ressources centralisées:instructions de configuration et conseils d'utilisation généraux, ainsi que informations d'assistance et de règlement pour l'API Picker et l'API Library.
- Sites dédiés aux API:sites individuels avec des guides détaillés, des documentations de référence et des exemples de code pour l'API Picker et l'API Library
- Mise à jour du contenu de la bibliothèque d'API:la documentation de la bibliothèque d'API a été révisée pour refléter les fonctionnalités de la bibliothèque d'API après la période d'abandon.
- Documentation ancienne conservée:nous avons conservé la documentation d'origine de l'API Library pour les développeurs qui doivent migrer les intégrations existantes. Si vous démarrez un nouveau projet, utilisez la documentation mise à jour. Si vous mettez à jour un projet existant, consultez la documentation ancienne et la documentation mise à jour si nécessaire pendant la migration.
Questions fréquentes
Qu'est-ce qui change avec les API Google Photos ?
Nous lançons la nouvelle API Google Photos Picker pour la sélection sécurisée de photos et mettons à jour l'API Library existante pour nous concentrer sur la gestion des photos et des vidéos créées par votre application.
Quand ces modifications prendront-elles effet ?
Ces modifications prendront effet le 31 mars 2025. Nous encourageons tous les utilisateurs d'intégrations existantes qui utilisent l'API Library pour la sélection de photos à migrer vers l'API Picker dès que possible.
Quel sera l'impact sur l'API Library ?
Les portées photoslibrary.readonly, photoslibrary.sharing et photoslibrary seront supprimées. Les appels d'API qui ne reposent que sur ces portées renverront un 403 PERMISSION_DENIED après le 31 mars 2025. 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 des champs d'application et méthodes concernés sur cette page.
Que dois-je faire si mon application utilise actuellement les portées ou méthodes concernées ?
Si votre application utilise l'une des portées ou méthodes concernées, nous vous recommandons de procéder comme suit:
- Pour la sélection de photos: passez à 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 nouveau moyen sécurisé pour les développeurs de permettre aux utilisateurs de sélectionner des photos et des vidéos dans leur bibliothèque Google Photos, et de les renvoyer facilement dans votre application.
Où puis-je trouver plus d'informations sur ces changements ?
La page que vous consultez actuellement fournit une présentation et un récapitulatif de toutes les modifications.
Le reste de la documentation de notre site a été mis à jour pour refléter les API mises à jour.
Cet article de blog annonce les modifications.
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 page d'assistance pour en savoir plus sur l'obtention d'aide.