L'API Library de Google Photos contient plusieurs champs d'application utilisés pour accéder aux éléments multimédias et aux albums. Les réponses renvoyées par différents appels varient selon les champs d'application demandés par le développeur.
Chaque requête envoyée par votre application à l'API Library de Google Photos doit inclure un jeton d'autorisation. Ce jeton permet également d'identifier votre application auprès de Google.
À propos des protocoles d'autorisation
Votre application doit autoriser les requêtes via le protocole OAuth 2.0. Les autres protocoles d'autorisation ne sont pas acceptés. Si votre application utilise la fonctionnalité Se connecter avec Google, certains aspects de l'autorisation sont traités pour vous.
Autoriser des requêtes avec OAuth 2.0
Toutes les requêtes adressées à l'API Library de Google Photos doivent être autorisées par un utilisateur authentifié.
Les détails de la procédure d'autorisation (ou "flux") relative à OAuth 2.0 varient légèrement selon le type d'application que vous développez. La procédure générale suivante s'applique à tous les types d'applications :
- Lorsque vous créez votre application, vous l'enregistrez dans la console d'API Google. Google fournit ensuite des informations dont vous aurez besoin ultérieurement, dont un ID client et un code secret du client.
- Activez l'API Library de Google Photos dans la console Google APIs. Si l'API ne figure pas dans la console, ignorez cette étape.
- Lorsque votre application doit accéder à des données utilisateur, elle demande à Google un champ d'application d'accès particulier.
- Google affiche alors un écran de consentement dans lequel l'internaute autorise votre application à demander certaines de ses données.
- Si l'utilisateur accepte, Google attribue à votre application un jeton d'accès temporaire.
- Votre application demande des données utilisateur en joignant le jeton d'accès à la requête.
- Dès lors que Google valide la requête et le jeton, les données demandées sont renvoyées.
Certains flux comportent d'autres étapes, comme l'utilisation de jetons d'actualisation afin d'obtenir de nouveaux jetons d'accès. Pour en savoir plus sur les flux concernant divers types d'applications, consultez la documentation OAuth 2.0 de Google.
Informations sur le champ d'application OAuth 2.0 pour l'API Library de Google Photos:
| Portée | Signification |
|---|---|
https://www.googleapis.com/auth/photoslibrary.readonly |
Répertorier les éléments de la bibliothèque et de tous les albums, accéder à l'ensemble des éléments multimédias et des albums appartenant à l'utilisateur, y compris ceux qui ont été partagés avec lui Pour les albums partagés par l'utilisateur, les propriétés de partage ne sont renvoyées que si le champ d'application La propriété Pour en savoir plus, consultez Partager des contenus multimédias. |
https://www.googleapis.com/auth/photoslibrary.appendonly |
Accès permettant d'importer des octets, de créer des éléments multimédias et des albums, et d'ajouter des enrichissements. Autoriser uniquement la création de contenus multimédias dans la bibliothèque de l'utilisateur et dans les albums créés par l'application. |
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata |
Accès en lecture aux éléments multimédias et aux albums créés par le développeur. Pour en savoir plus, consultez Accéder aux éléments multimédias et Répertorier le contenu, les albums et les éléments multimédias de la bibliothèque. Destiné à être demandé avec le champ d'application |
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata |
Accès en modification uniquement. Accès permettant de modifier les informations suivantes concernant les albums et les éléments multimédias créés par le développeur: |
https://www.googleapis.com/auth/photoslibrary.sharing |
Accès permettant de créer un album, de le partager, d'y importer des éléments multimédias et de rejoindre un album partagé |
https://www.googleapis.com/auth/photoslibrary |
Utilisation déconseillée Demandez uniquement l'accès aux champs d'application dont vous avez besoin avec l'autorisation incrémentielle.
Accès aux champs d'application |
Pour demander l'accès via OAuth 2.0, votre application a besoin du champ d'application ainsi que des informations fournies par Google lors de son enregistrement (ID et code secret du client, par exemple).
Conseil : Les bibliothèques clientes des API Google peuvent gérer une partie de la procédure d'autorisation à votre place. Elles sont disponibles pour une grande variété de langages de programmation. Pour en savoir plus, accédez à la page Exemples de code et bibliothèques clientes.
Sélectionner des champs d'application
En règle générale, choisissez le champ d'application le plus restrictif possible et évitez de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des niveaux d'accès limités et clairement décrits. Les utilisateurs peuvent hésiter à accorder un accès étendu à leurs contenus multimédias, sauf s'ils font confiance à votre application et comprennent pourquoi elle a besoin des informations.
Demander des niveaux d'accès de manière incrémentielle
Conformément aux bonnes pratiques d'autorisation, votre application ne doit demander des champs d'application que si nécessaire. Évitez de demander à l'avance tous les champs d'application de votre application lors de la connexion. Fournissez plutôt une justification et effectuez la requête en contexte. Expliquez clairement ce que vous allez faire de vos données utilisateur et ce qu'elles retireront de votre accès, conformément aux Consignes et bonnes pratiques relatives à l'expérience utilisateur, pour fournir un préavis et demander le consentement des utilisateurs.
Comptes de service
L'API Library n'est pas compatible avec les comptes de service. Votre application doit utiliser les autres flux OAuth 2.0, tels que OAuth 2.0 pour les applications de serveur Web ou OAuth 2.0 pour les applications mobiles et de bureau.