Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.
Premiers pas avec REST
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour commencer à utiliser l'API Library de Google Photos, configurez votre projet en l'activant via
la console Google APIs et configurer
un ID client OAuth 2.0.
Votre application interagit avec Google Photos pour le compte d'un
Utilisateur Google Photos. Par exemple, lorsque vous créez des albums dans le dossier
bibliothèque Google Photos ou d'importer des éléments multimédias
compte Google Photos, l'utilisateur autorise ces requêtes API via le
Protocole OAuth 2.0.
L'ID client OAuth 2.0 permet aux utilisateurs
de votre application de se connecter,
et ainsi utiliser l'API Library. L'API Library ne prend pas en charge
des comptes de service ; Pour utiliser cette API, les utilisateurs doivent être connectés à un compte
Compte.
Activer l'API
Avant de pouvoir utiliser l'API Library, vous devez l'activer pour votre projet.
- Accédez à la console Google APIs.
- Dans la barre de menu, sélectionnez un projet ou créez-en un.
- Pour ouvrir la bibliothèque d'API Google, dans le menu de navigation, sélectionnez
API et Services > bibliothèque.
- Recherchez "API Library de Google Photos". Sélectionnez le résultat correct, puis cliquez sur
Activer :
Demander un ID client OAuth 2.0
Suivez les étapes ci-dessous pour demander un ID client OAuth et le configurer pour votre
application. Cet exemple utilise une application où l'intégralité du flux OAuth est
gérés côté serveur, comme celui de nos exemples. Le processus de configuration peut varier
pour découvrir d'autres scénarios de mise en œuvre.
- Accédez à la console Google APIs.
et sélectionnez votre projet.
- Dans le menu, sélectionnez API et Services > Identifiants
- Sur la page Identifiants, cliquez sur Créer des identifiants > ID client OAuth.
- Sélectionnez le type d'application. Dans cet exemple, le type d'application est
Application Web :
Enregistrer les origines à partir desquelles votre application est autorisée à accéder aux API Google
comme suit:
- Pour identifier l'ID client, saisissez un nom.
Dans le champ Origines JavaScript autorisées, saisissez l'origine de votre
l'application. Les caractères génériques ne sont pas acceptés dans ce champ.
Vous pouvez saisir plusieurs origines pour permettre à votre appli de s'exécuter sur différentes
protocoles, domaines ou sous-domaines. Les URL que vous saisissez sont autorisées à
pour lancer une requête OAuth.
L'exemple suivant illustre une URL de développement en local (dans nos exemples,
localhost:8080) et une URL de production.
http://localhost:8080
https://myproductionurl.example.com
Le champ URI de redirection autorisé correspond au point de terminaison qui reçoit
du serveur OAuth 2.0. Il s'agit généralement
environnement de développement et pointe vers un chemin d'accès dans votre application.
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
Cliquez sur Créer.
-
Dans la boîte de dialogue du client OAuth qui s'affiche, copiez les éléments suivants:
- ID client
- Code secret du client
Votre application peut accéder aux API Google activées à l'aide de ces valeurs.
Avant de pouvoir lancer une application publique
qui accède à l'API Library,
votre application doit être examinée par Google. Une "Application non validée" s'affiche sur le
lorsque vous testez votre application, jusqu'à ce qu'elle soit
validé.
Essayer l'exemple
Maintenant que vous avez configuré votre projet pour l'utiliser avec l'API Library,
consultez l'application exemple sur GitHub. Application exemple
montre comment créer un cadre photo intelligent à l'aide de l'API Library.
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\u003eTo use the Google Photos Library API, you must enable the API and set up an OAuth 2.0 client ID through the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eUsers must be signed in to a valid Google Account to use the Library API as it requires user authorization via OAuth 2.0 for actions like creating albums or uploading media.\u003c/p\u003e\n"],["\u003cp\u003eBefore launching publicly, your application needs to be reviewed and verified by Google to remove the "Unverified app" message during testing.\u003c/p\u003e\n"]]],["To utilize the Google Photos Library API, first enable it for your project in the Google API Console. Then, create an OAuth 2.0 client ID, specifying the application type, authorized JavaScript origins, and redirect URIs. Obtain the client ID and secret from the resulting dialog. Ensure your application is reviewed by Google before public launch. Note, only valid Google Account users can use this API as service accounts aren't supported.\n"],null,["# Get started with REST\n\nTo start using the Google Photos Library API, configure your project by enabling the API via\nthe Google API Console and setting up an OAuth 2.0 client ID.\n\nYour application interacts with Google Photos on behalf of a\nGoogle Photos user. For instance, when you create albums in a user's\nGoogle Photos library or upload media items to a user's\nGoogle Photos account, the user authorizes these API requests via the\n[OAuth 2.0](/identity/protocols/OAuth2) protocol.\n\nThe OAuth 2.0 client ID allows your application users to sign in, authenticate,\nand thereby use the Library API. The Library API does not support\nservice accounts; to use this API, users must be signed in to a valid Google\nAccount.\n\nConfigure your app\n------------------\n\n### Enable the API\n\nBefore you can use the Library API, you must enable it for your project.\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library).\n2. From the menu bar, select a project or create a new project.\n3. To open the Google API Library, from the Navigation menu, select **APIs \\& Services \\\u003e Library**.\n4. Search for \"Google Photos Library API\". Select the correct result and click **Enable**.\n\n### Request an OAuth 2.0 client ID\n\nFollow the steps below to request an OAuth client ID and configure it for your\napplication. This example uses an application where the entire OAuth flow is\nhandled server-side, such as the one in our samples. The setup process may vary\nfor other [implementation scenarios](/identity/protocols/OAuth2).\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library) and select your project.\n2. From the menu, select **APIs \\& Services \\\u003e Credentials**.\n3. On the **Credentials** page, click **Create Credentials \\\u003e OAuth client ID**.\n4. Select your **Application type** . In this example, the application type is **Web application**.\n5. Register the origins from which your app is allowed to access the Google APIs\n as follows:\n\n 1. To identify the client ID, enter a name.\n 2. In the **Authorized JavaScript origins** field, enter the origin for your\n app. This field doesn't allow wildcards.\n\n You can enter multiple origins to allow your app to run on different\n protocols, domains, or subdomains. The URLs you enter are allowed to\n start an OAuth request.\n\n The following example shows a local development URL (our samples use\n `localhost:8080`) and a production URL. \n\n http://localhost:8080\n https://myproductionurl.example.com\n\n 3. The **Authorized redirect URI** field is the endpoint that receives\n responses from the OAuth 2.0 server. Typically, this includes your\n development environment and points to a path in your application.\n\n http://localhost:8080/auth/google/callback\n https://myproductionurl.example.com/auth/google/callback\n\n 4. Click **Create**.\n\n\u003c!-- --\u003e\n\n6. From the resulting OAuth client dialog, copy the following:\n\n - Client ID\n - Client secret\n\n Your app can access the enabled Google APIs using these values.\n\nBefore you can launch a public application that accesses the Library API,\nyour app must be reviewed by Google. An \"Unverified app\" message appears on the\nscreen when you test your application, until it is\n[verified](https://support.google.com/cloud/answer/7454865).\n\nTry out the sample\n------------------\n\nNow that you've configured your project for use with the Library API,\ncheck out the [sample app](/photos/library/samples) on GitHub. The sample app\ndemonstrates how you can build a smart photo frame using the Library API."]]
