Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.
Présentation de l'API Library
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
À l'aide de l'API Library de Google Photos, votre application peut lire, écrire et partager des photos et des vidéos dans Google Photos.
L'API Library est une API RESTful avec une charge utile JSON. La structure de l'API est basée sur les concepts de produit de Google Photos:
- Library (Bibliothèque) : contenus multimédias stockés dans le compte Google Photos de l'utilisateur.
- Albums: collections multimédias pouvant être partagées avec d'autres utilisateurs.
- Éléments multimédias: photos, vidéos et métadonnées associées.
- Partage: fonctionnalité qui permet aux utilisateurs de partager leurs contenus multimédias avec d'autres utilisateurs.
L'autorisation
Comme d'autres API REST Google, l'API Library utilise OAuth 2.0 pour gérer les autorisations.
Votre application peut demander l'accès à la bibliothèque Google Photos de l'utilisateur via les différents champs d'application d'autorisation fournis par l'API.
Notez que l'API Library n'est pas compatible avec les comptes de service. Pour l'utiliser, les utilisateurs doivent être connectés à un compte Google valide.
Utiliser l'API Library
Avant de commencer à développer votre application, tenez compte des points suivants:
Explorer l'API
Pour tester l'API Library sans écrire de code, utilisez APIs Explorer disponible dans la documentation de référence.
Voici quelques méthodes pour essayer d'utiliser APIs Explorer:
Consultez notre exemple de code qui montre certaines des principales fonctionnalités de l'API Library.
Programme Partenaires
Vous pouvez intégrer l'API Google Photos Library sans rejoindre le programme Partenaire.
Toutefois, si votre application est susceptible de dépasser la limite de quota de disponibilité générale, demandez à participer au Programme de partenariat Google Photos.
En savoir plus
Voici quelques suggestions:
- Premiers pas: configurez votre projet et testez l'exemple.
- Guides: guides d'utilisation et concepts liés à l'utilisation de l'API Library.
- Référence: documentation de référence de l'API
- Assistance: options d'assistance pour demander de l'aide ou envoyer des commentaires.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThe Google Photos Library API allows your app to read, write, and share photos and videos stored in Google Photos.\u003c/p\u003e\n"],["\u003cp\u003eIt uses a RESTful API with JSON payload and OAuth 2.0 for authorization, requiring users to be signed in to a Google Account.\u003c/p\u003e\n"],["\u003cp\u003eBefore developing your app, review the acceptable use policy, UX guidelines, and API limits and quotas.\u003c/p\u003e\n"],["\u003cp\u003eExplore the API through the API Explorer or by checking out the provided code samples.\u003c/p\u003e\n"],["\u003cp\u003eConsider joining the Google Photos partner program if your app is likely to exceed the general availability quota limit.\u003c/p\u003e\n"]]],["The Google Photos Library API enables apps to interact with Google Photos content, reading, writing, and sharing photos and videos. It's a RESTful API using JSON payloads, organized around libraries, albums, media items, and sharing. Access requires OAuth 2.0 authorization via specific scopes, and service accounts are not supported. Developers should adhere to usage policies, UX guidelines, and quotas. The API can be explored through the API Explorer, and code samples are available. Those who need more quota should apply to the Google Photos partner program.\n"],null,["# Library API overview\n\nUsing the Google Photos Library API your app can read, write, and share photos and videos in\nGoogle Photos.\n\nThe Library API is a [RESTful\nAPI](/photos/library/legacy/guides/about-restful-apis) with JSON payload. The structure\nof the API is based on the product concepts of Google Photos:\n\n- [Library](/photos/library/legacy/guides/list): media stored in the user's Google Photos account.\n- [Albums](/photos/library/legacy/guides/manage-albums): media collections which can be shared with other users.\n- [Media items](/photos/library/legacy/guides/access-media-items): photos, videos, and their metadata.\n- [Sharing](/photos/library/legacy/guides/share-media): feature that enables users to share their media with other users.\n\nAuthorization\n-------------\n\nLike other Google REST APIs, the Library API uses [OAuth\n2.0](/identity/protocols/OAuth2) to handle authorization.\nYour app can request access to the user's Google Photos library via the\nvarious [authorization\nscopes](/photos/library/legacy/guides/authorization) provided by the\nAPI.\n\nNote that the Library API does not support service accounts; to use this\nAPI, users must be signed in to a valid Google Account.\n\nUsing the Library API\n---------------------\n\nBefore you get started on your app development, keep the following in mind:\n\n- [Acceptable use policy](/photos/library/legacy/guides/acceptable-use)\n- [UX guidelines](/photos/library/legacy/guides/ux-guidelines) for designing your app\n- The Library API [limits and\n quotas](/photos/library/legacy/guides/api-limits-quotas)\n\nExplore the API\n---------------\n\nTo try out the Library API without writing any code, use the API Explorer\navailable in the reference documentation.\n\nHere are some methods to try using the API Explorer:\n\n- [List](/photos/library/legacy/reference/rest/v1/albums/list) your albums.\n- Apply filters to a [media item\n search](/photos/library/legacy/reference/rest/v1/mediaItems/search).\n\nCheck out our [code sample](/photos/library/samples) that shows some of the key\nfeatures of the Library API.\n\nPartner program\n---------------\n\nYou can integrate with the Google Photos Library API without joining the partner program.\nHowever, if your app is likely to exceed the general availability [quota\nlimit](/photos/library/legacy/guides/api-limits-quotas), express interest in the [Google Photos\npartner program](/photos/partner-program).\n\nLearn more\n----------\n\nSome places to go from here:\n\n- [Get started](/photos/library/legacy/guides/get-started): configure your project and try out the sample.\n- [Guides](/photos/library/legacy/guides/list): the how-to guides and concepts around using the Library API.\n- [Reference](/photos/library/reference): the API reference documentation\n- [Support](/photos/library/support/how-to-get-help): the support options for requesting help or giving feedback."]]
