Découvrez la nouvelle API Picker et les modifications importantes apportées à l'API Library.
En savoir plus
Method: sessions.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Une fois qu'un utilisateur appuie sur le bouton OK pour terminer une session de picking, pickerUri ne fonctionne plus. Créez une session pour permettre à l'utilisateur de sélectionner d'autres photos.
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/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThis endpoint creates a session for users to select photos and videos for third-party access.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eFAILED_PRECONDITION\u003c/code\u003e error occurs if the user lacks an active Google Photos account.\u003c/p\u003e\n"],["\u003cp\u003eExcessive session creation leads to a \u003ccode\u003eRESOURCE_EXHAUSTED\u003c/code\u003e error, though unlikely under normal use.\u003c/p\u003e\n"],["\u003cp\u003eClients should call \u003ccode\u003esessions.delete\u003c/code\u003e after each session to avoid exceeding resource limits.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/photospicker.mediaitems.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["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"],null,["# Method: sessions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nGenerates a new session during which the user can pick photos and videos for third-party access.\n\nIf the user doesn't have an active Google Photos account, a `FAILED_PRECONDITION` error is returned.\n\nIf the client application creates too many sessions per user, a `RESOURCE_EXHAUSTED` error is returned. Clients are unlikely to reach these limits under normal circumstances. However, clients are still recommended to call `sessions.delete` after each session, to proactively stay within resource limits.\n\nOnce [a user taps the **Done**](https://developers.google.com/photos/picker/guides/picking-experience#done_screen) button to complete a picking session, the `pickerUri` will no longer work. Create a new session to allow the user to pick more photos.\n\n### HTTP request\n\n`POST https://photospicker.googleapis.com/v1/sessions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` Optional. A client-provided unique identifier for this request. This ID is used to enable the streamlined picking experience for applications using the OAuth 2.0 flow for limited-input devices. This ID must have the format of a UUID (version 4) string and follow these requirements: - Must not contain any sensitive identifying information about the user. - Must contain 32 hexadecimal characters divided into five groups separated by hyphens, in the format \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\" (or 8-4-4-4-12). |\n\n### Request body\n\nThe request body contains an instance of [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photospicker.mediaitems.readonly`"]]
