Découvrez la nouvelle API Picker et les modifications importantes apportées à l'API Library.
En savoir plus
Method: sessions.create
Génère une nouvelle session au cours de laquelle l'utilisateur peut sélectionner des photos et des vidéos pour un accès tiers.
Si l'utilisateur ne dispose pas d'un compte Google Photos actif, une erreur FAILED_PRECONDITION est renvoyée.
Si l'application cliente crée trop de sessions par utilisateur, une erreur RESOURCE_EXHAUSTED est renvoyée. En temps normal, les clients ne devraient pas atteindre ces limites. Toutefois, nous recommandons toujours aux clients d'appeler sessions.delete après chaque session afin de respecter de manière proactive les limites de ressources.
Requête HTTP
POST https://photospicker.googleapis.com/v1/sessions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
| Paramètres |
requestId |
string
Facultatif. Identifiant unique fourni par le client pour cette requête. Cet ID permet de simplifier l'expérience de sélection pour les applications qui utilisent le flux OAuth 2.0 pour les appareils à saisie limitée. Cet ID doit avoir le format d'une chaîne UUID (version 4) et respecter les exigences suivantes:
- Ne doit pas contenir d'informations d'identification sensibles sur l'utilisateur.
- Doit contenir 32 caractères hexadécimaux divisés en cinq groupes séparés par des tirets, au format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (ou 8-4-4-4-12).
|
Corps de la requête
Le corps de la requête contient une instance de PickingSession.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de PickingSession.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
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/03/10 (UTC).
[null,null,["Dernière mise à jour le 2025/03/10 (UTC)."],[[["This endpoint creates a session for users to select photos and videos for third-party access."],["A `FAILED_PRECONDITION` error occurs if the user lacks an active Google Photos account."],["Excessive session creation leads to a `RESOURCE_EXHAUSTED` error, though unlikely under normal use."],["Clients should call `sessions.delete` after each session to avoid exceeding resource limits."],["Requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope for authorization."]]],["This describes the creation of a new session for users to grant third-party access to their photos and videos. It uses a `POST` request to `https://photospicker.googleapis.com/v1/sessions`. The request body contains a `PickingSession` instance, and a successful response returns a new `PickingSession`. Requires `photospicker.mediaitems.readonly` OAuth scope. Errors include `FAILED_PRECONDITION` for inactive accounts and `RESOURCE_EXHAUSTED` for excessive session creation. Deleting sessions with `sessions.delete` is recommended to manage resources.\n"]]
