Method: sessions.create
Создает новый сеанс, во время которого пользователь может выбирать фотографии и видео для доступа третьих лиц.
Если у пользователя нет активной учетной записи Google Фото, возвращается ошибка FAILED_PRECONDITION
.
Если клиентское приложение создает слишком много сеансов для каждого пользователя, возвращается ошибка RESOURCE_EXHAUSTED
. Клиенты вряд ли достигнут этих пределов при нормальных обстоятельствах. Однако клиентам по-прежнему рекомендуется вызывать sessions.delete
после каждого сеанса, чтобы заранее оставаться в пределах ограничений ресурсов.
HTTP-запрос
POST https://photospicker.googleapis.com/v1/sessions
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит экземпляр PickingSession
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр PickingSession
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-08 UTC.
[null,null,["Последнее обновление: 2025-01-08 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"]]