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 activa de Google Fotos, 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.
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-03-10 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]
