Notes de version

Abonnez-vous à ces notes de version.

Cette page est mise à jour à chaque nouvelle version des API Google Photos. Le journal des modifications liste les versions par date et inclut les nouvelles fonctionnalités, les corrections de bugs et d'autres modifications.

La documentation et les guides indiquent la dernière version à utiliser.

1er avril 2025

Remarques

Cette version implémente les modifications précédemment annoncées apportées aux API Photos.

• Suppression de certains champs d'application de l'API Library.
• Restriction de plusieurs méthodes pour qu'elles ne fonctionnent qu'avec le contenu créé par l'application.
• Le nouveau Règlement pour les développeurs et les données utilisateur de l'API Photos remplace l'ancienne politique d'utilisation autorisée.

Pour en savoir plus, consultez Changements concernant les API Google Photos.

16 septembre 2024

Fonctionnalités

• Introduction de la nouvelle API Picker pour une sélection de photos sécurisée et conviviale.

Remarques

Dans cette version, nous avons annoncé des modifications importantes apportées à l'API Library (qui prendront effet le 31 mars 2025).

• L'API Library ne gère que les photos et vidéos créées par votre application.
• Suppression des habilitations photoslibrary.readonly, photoslibrary.sharing et photoslibrary.
• Restriction de plusieurs méthodes au contenu créé par l'application uniquement.

Pour en savoir plus, consultez la page Changements concernant les API Google Photos.

27 octobre 2022

Remarques

• L'atelier de programmation "Créer une application de partage de photos avec Google Photos et Flutter" n'est plus disponible. Consultez nos autres exemples et reportez-vous à l'exemple de code de nos guides.

1er juin 2022

Remarques

• Ajout de bonnes pratiques pour l'importation afin d'éclaircir le processus d'importation, d'identifier les erreurs courantes et de savoir comment les éviter, et de fournir des conseils pour améliorer l'efficacité de l'importation.

27 octobre 2021

Fonctionnalités

• Programme Partenaires Google Photos: lancement du niveau Premier. Le niveau Premier est une suite de fonctionnalités d'API améliorées qui exploitent la puissante intelligence artificielle de Google Photos.

29 septembre 2021

Fonctionnalités

• Nouvelle option permettant de trier les recherches basées sur un filtre de date. Vous pouvez trier les résultats par ordre croissant ou décroissant. Cela permet de faciliter les recherches et d'améliorer l'efficacité en fournissant des résultats de recherche plus ciblés.

21 juillet 2021

Fonctionnalités

• Nouveau paramètre -no pour les URL de base des vidéos permettant de charger des miniatures sans superposition de bouton de lecture. Par défaut, les miniatures de vidéos se chargent avec une superposition de bouton de lecture. Ce nouveau paramètre vous permet de masquer le bouton de lecture sur les miniatures de vidéos.

Problèmes résolus

• Problème 181282432: les miniatures des vidéos sont toujours affichées avec un bouton de lecture en superposition.

25 mai 2021

Problèmes résolus

• La propriété exposureTime n'a pas été renseignée pour les métadonnées photo dans les éléments multimédias.

19 mai 2021

Remarques

• La documentation sur l'URL de base pour les photos animées a été mise à jour pour clarifier le comportement du paramètre =dv pour les photos animées Android et les photos en direct iOS.

11 février 2021

Remarques

• La Politique d'utilisation autorisée a été mise à jour pour inclure des informations sur la publicité et réduire l'utilisation des données.

7 juillet 2020

Fonctionnalités

• L'API a été mise à jour pour prendre en charge les nouvelles commandes de partage dans Google Photos. Un nouveau champ, isJoinable, est désormais renvoyé dans la propriété shareInfo pour les albums partagés. L'API peut associer des utilisateurs à un album partagé lorsque isJoinable est true. Si un propriétaire a désactivé le partage par lien sur un album dans Google Photos, isJoinable sera false, et l'API ne pourra pas associer des utilisateurs à cet album.
• Problèmes 111405623, 116379853 et 117685011: vous pouvez désormais modifier les titres et les photos de couverture des albums, ainsi que les descriptions des éléments multimédias créés par votre application. Demandez le nouveau champ d'application d'autorisation photoslibrary.edit.appcreateddata pour l'accès aux mises à jour.

17 février 2020

Fonctionnalités

• La taille maximale d'importation d'une photo est passée de 75 Mo à 200 Mo.
• Lorsque vous importez des fichiers, un type MIME doit désormais être spécifié à l'étape d'importation des octets.
• Vous devez désormais spécifier des noms de fichiers lorsque vous créez un élément multimédia, et non lorsque vous importez des octets multimédias. La nouvelle propriété fileName dans simpleMediaItem est compatible avec les chaînes UTF-8. Vous pouvez toujours spécifier le nom de fichier d'un élément multimédia lorsque vous importez des octets multimédias. Toutefois, nous vous recommandons vivement de mettre à jour votre implémentation.

Remarques

• La Politique d'utilisation autorisée a été mise à jour avec des informations supplémentaires axées sur la réduction de l'utilisation et du stockage des données.
• La documentation sur l'URL de base a été mise à jour pour inclure les photos animées.

16 août 2019

Fonctionnalités

• Problème 131874809: nouvelle propriété isOwned dans shareInfo pour identifier si l'utilisateur est le propriétaire de l'album partagé. Pour en savoir plus, consultez le guide du développeur sur le partage de contenus multimédias.

Problèmes résolus

• Problème 131711405: la propriété shareableUrl était manquante dans la réponse albums.list.
• Problème 113870729 : mediaItems.list renvoyait parfois des éléments multimédias en double aux limites de page.
• Problème 93428763: le champ status des métadonnées vidéo renvoie désormais correctement le VideoProcessingStatus de la vidéo de la plus haute qualité disponible.

12 juin 2019

Fonctionnalités

• Problème 110188560: nouveau filtre de recherche permettant de sélectionner les éléments multimédias marqués comme favoris : FeatureFilter.
• Nouvelles catégories de contenu pour ContentFilter afin de filtrer les éléments multimédias correspondant à des catégories spécifiques: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Remarques

• Mise à jour des consignes relatives à l'expérience utilisateur qui fournissent des conseils supplémentaires sur le nom des projets et des albums.

7 mai 2019

Ateliers de programmation

• Nouvel atelier de programmation: Créer une application de partage de photos avec Google Photos et Flutter Découvrez comment créer une application de partage de photos à l'aide de l'API Library de Google Photos dans Flutter. Pour en savoir plus, consultez le guide des exemples.

29 avril 2019

Fonctionnalités

• Problème 109505022: nouveaux appels pour ajouter et supprimer des éléments multimédias existants à un album:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Ces appels sont compatibles avec les éléments multimédias et les albums créés par votre application. Pour en savoir plus, consultez le guide du développeur sur la gestion des albums.

• L'appel REST permettant de créer des éléments multimédias mediaItems.batchCreate renvoie désormais l'état HTTP 207 MULTI-STATUS pour un succès partiel si certains éléments multimédias n'ont pas pu être créés. Pour en savoir plus, consultez le guide du développeur sur l'importation de contenus multimédias.

Remarques

• Les dernières versions des bibliothèques clientes incluent une modification destructive. Les classes associées à MediaItem, Album et DateRange ont été déplacées vers un nouveau package dédié. Leurs fonctionnalités n'ont pas changé, mais leur emplacement dans la bibliothèque cliente. Consultez les notes de version de la bibliothèque cliente Java (1.2.0) et de la bibliothèque cliente PHP (1.2.0).

14 février 2019

Remarques

• Une nouvelle limite de quota s'applique pour accéder aux octets multimédias à partir d'URL de base. Vous pouvez surveiller ce quota dans la console Google API.

Problèmes résolus

• Problème 124355983: erreurs 500 lors de l'appel de mediaItems.get pour certains éléments multimédias partagés.

21 janvier 2019

Problèmes résolus

• Problème 121998358: la propriété isWriteable était manquante dans la réponse albums.create.

7 janvier 2019

Problèmes résolus

• Problème 118464845: mediaItems.list a renvoyé trop de pages vides.
• Problème 111714379: mediaItems.search renvoyait la moitié de pageSize.

30 novembre 2018

Fonctionnalités

• Nouvel appel mediaItems.batchGet pour récupérer plusieurs éléments multimédias à l'aide de leurs identifiants.
• Problème 111279349: nouvel appel sharedAlbums.leave pour quitter un album associé.
• Problème 111279347: nouvel appel albums.unshare pour marquer un album partagé comme privé.

Problèmes résolus

• Problème 113978705: les descriptions définies dans mediaItems.batchCreate ont été converties en entités HTML.
• Problème 114462217: le nom de fichier n'a pas pu être défini pour les fichiers vidéo dans mediaItems.batchCreate.
• Problème 118475587: des URL de produits non valides ont été renvoyées pour les éléments multimédias.
• Problème 111862704: erreurs 403 lors de l'accès aux URL de base.
• Problème 115932469: les importations échouent en raison d'une erreur de quota.

6 septembre 2018

Fonctionnalités

• Les bibliothèques clientes Java et PHP sont désormais disponibles.

Remarques

• L'API Library de Google Photos est désormais disponible pour tous les utilisateurs. Merci de vos commentaires et de vos demandes de fonctionnalités pendant la période de version preview développeur de l'API Library.
• Consultez les nouveaux guides de démarrage des bibliothèques clientes Java et PHP.
• Des extraits de code Java et PHP ont été ajoutés aux guides pour illustrer l'utilisation des bibliothèques clientes.

5 septembre 2018

Fonctionnalités

• Nouvel appel sharedAlbums.get pour obtenir un album à l'aide de shareToken.
• Nouvelle propriété isJoined dans shareInfo pour identifier si l'utilisateur a rejoint l'album partagé.

Problèmes résolus

• Problème 79321120: la propriété mimeType était manquante dans la réponse mediaItems.batchCreate pour les éléments multimédias vidéo.
• Problème 79319272: des propriétés telles que mediaMetadata et contributorInfo étaient manquantes dans la réponse mediaItems.batchCreate.
• Problème 110237685: correction d'un problème d'importation de fichiers lié à CORS.
• Problème 79318118: l'ordre n'était pas maintenu lors de l'importation de plusieurs éléments dans un album dans l'appel mediaItems.batchCreate.

Remarques

• Si vous avez stocké des ID (comme ceux des albums, des éléments multimédias ou des éléments d'enrichissement) avant le 5 septembre 2018, ils ne fonctionneront plus, car le format a changé. Vous devrez obtenir de nouveaux identifiants à utiliser dans votre application.
• La propriété totalMediaItems de la ressource album a été renommée mediaItemsCount.
• La valeur maximale du paramètre pageSize dans les appels mediaItems.list et mediaItems.search a été définie sur 100. Le nombre par défaut d'éléments multimédias renvoyés lorsque le paramètre pageSize n'est pas spécifié a été défini sur 25.
• Mise à jour des guides Lister le contenu de la bibliothèque, Partager des contenus multimédias et Accéder aux éléments multimédias avec la fonctionnalité de filtrage excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) publiée le 31 juillet 2018.

31 juillet 2018

Fonctionnalités

• Nouvel appel mediaItems.list pour lister les éléments multimédias.
• Nouveau filtre excludeNonAppCreatedData pour rechercher des éléments ou lister des albums créés par votre application.
• Nouveaux paramètres pour accéder aux images :
  • Problème 79871479: paramètre de recadrage c pour recadrer l'image selon des dimensions exactes.
  • Problème 110343547, Problème 111228390: paramètre de téléchargement d pour télécharger l'image d'origine.
• L'appel sharedAlbums.join renvoie désormais un album.
• Problème 109655786 : album contient désormais l'ID de l'élément multimédia de la photo de couverture, coverPhotoMediaItemId.
• Problème 79656863 : mediaItem contient désormais le nom de fichier de l'élément multimédia, filename.

Problèmes résolus

• Problème 79757390: le nom du fichier n'était pas défini lors des demandes d'importation. Consultez les champs X-Goog-Upload-File-Namefile et X-Goog-Upload-Protocol dans le guide Importer des contenus multimédias.
• Problème 80182372: les importations avec reprise ont renvoyé une erreur. Consultez le nouveau guide sur les importations avec reprise pour le protocole mis à jour.
• Problème 79497397: propriété isWriteable manquante dans la réponse albums.list.
• Problème 111143493: le filtre de catégorie de contenu PEOPLE renvoyait des résultats inexacts.
• Problème 111056278: le filtre de catégorie de contenu BIRTHDAYS renvoyait une erreur.

Version Preview : 8 mai 2018

Version initiale de l'API Library.

Problèmes connus

• GET mediaItem génère une erreur si l'élément multimédia id qu'il reçoit provient d'un album partagé et n'appartient pas à l'utilisateur.
• La réponse de l'appel batchCreate ne renverra pas mediaMetadata ni contributorInfo.
• Si l'élément multimédia est une vidéo, l'appel batchCreate ne renvoie pas de mimeType.
• batchCreate ne maintient pas l'ordre cohérent lors de l'importation de plusieurs éléments.
• batchCreate n'est pas compatible avec l'ordre (ajout dans un position) lors de la création d'éléments multimédias dans un album partagé en tant que propriétaire de l'album partagé. Par défaut, il est placé à la fin de l'album.