Method: sessions.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает новый сеанс, во время которого пользователь может выбирать фотографии и видео для доступа третьих лиц.
Если у пользователя нет активной учетной записи Google Фото, возвращается ошибка FAILED_PRECONDITION
.
Если клиентское приложение создает слишком много сеансов для каждого пользователя, возвращается ошибка RESOURCE_EXHAUSTED
. Клиенты вряд ли достигнут этих пределов при обычных обстоятельствах. Однако клиентам по-прежнему рекомендуется вызывать sessions.delete
после каждого сеанса, чтобы заранее оставаться в пределах ограничений ресурсов.
HTTP-запрос
POST https://photospicker.googleapis.com/v1/sessions
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
requestId | string Необязательный. Уникальный идентификатор, предоставленный клиентом для этого запроса. Этот идентификатор используется для упрощения процесса выбора для приложений, использующих поток OAuth 2.0 для устройств с ограниченным вводом. Этот идентификатор должен иметь формат строки UUID (версия 4) и соответствовать следующим требованиям: - Не должно содержать никакой конфиденциальной идентификационной информации о пользователе.
- Должно содержать 32 шестнадцатеричных символа, разделенных на пять групп, разделенных дефисами, в формате «ххххххх-хххх-хххх-хххх-ххххххххххх» (или 8-4-4-4-12).
|
Тело запроса
Тело запроса содержит экземпляр PickingSession
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр PickingSession
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-03-10 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 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"]]