Method: sessions.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Genera una sesión nueva durante la cual el usuario puede elegir fotos y videos para el acceso de terceros.
Si el usuario no tiene una cuenta de Google Fotos activa, se muestra un error FAILED_PRECONDITION.
Si la aplicación cliente crea demasiadas sesiones por usuario, se muestra un error RESOURCE_EXHAUSTED. Es poco probable que los clientes alcancen estos límites en circunstancias normales. Sin embargo, se recomienda que los clientes llamen a sessions.delete después de cada sesión para mantenerse dentro de los límites de recursos de forma proactiva.
Una vez que un usuario presiona el botón Listo para completar una sesión de selección, pickerUri dejará de funcionar. Crea una sesión nueva para permitir que el usuario elija más fotos.
Solicitud HTTP
POST https://photospicker.googleapis.com/v1/sessions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros |
requestId |
string
Opcional. Es un identificador único proporcionado por el cliente para esta solicitud. Este ID se usa para habilitar la experiencia de selección optimizada para las aplicaciones que usan el flujo de OAuth 2.0 para dispositivos de entrada limitada. Este ID debe tener el formato de una cadena de UUID (versión 4) y cumplir con los siguientes requisitos:
- No debe contener información de identificación sensible sobre el usuario.
- Debe contener 32 caracteres hexadecimales divididos en cinco grupos separados por guiones, en el formato “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” (o 8-4-4-4-12).
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de PickingSession.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de PickingSession.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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`"]]
