Method: sessions.create

Создает новый сеанс, во время которого пользователь может выбирать фотографии и видео для доступа третьих лиц.

Если у пользователя нет активной учетной записи Google Фото, возвращается ошибка FAILED_PRECONDITION .

Если клиентское приложение создает слишком много сеансов для каждого пользователя, возвращается ошибка RESOURCE_EXHAUSTED . Клиенты вряд ли достигнут этих пределов при обычных обстоятельствах. Однако клиентам по-прежнему рекомендуется вызывать sessions.delete после каждого сеанса, чтобы заранее оставаться в пределах ограничений ресурсов.

Как только пользователь нажмет кнопку «Готово» , чтобы завершить сеанс сбора, pickerUri перестанет работать. Создайте новый сеанс, чтобы позволить пользователю выбрать больше фотографий.

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