REST Resource: sessions
Ресурс: PickingSession
Представление пользовательского сеанса, во время которого пользователь может выбирать фотографии и видео с помощью Google Фото.
JSON-представление |
---|
{
"id": string,
"pickerUri": string,
"pollingConfig": {
object (PollingConfig )
},
"expireTime": string,
"mediaItemsSet": boolean
} |
Поля |
---|
id | string Только вывод. Идентификатор, сгенерированный Google для этого сеанса. |
pickerUri | string Только вывод. URI, используемый для перенаправления пользователя в Google Фото (в Интернете), чтобы он мог выбирать фотографии и видео для текущего сеанса. Чтобы успешно просмотреть эту страницу, пользователь должен войти в учетную запись Google, которой принадлежит этот сеанс, в своем веб-браузере. pickerUri не может быть открыт в iframe по соображениям безопасности. |
pollingConfig | object ( PollingConfig ) Только вывод. Рекомендуемая конфигурация, которую приложения должны использовать при опросе sessions.get . Это поле заполняется только в том случае, если элементы мультимедиа еще не выбраны для этого сеанса (т. е. mediaItemsSet имеет значение false). |
expireTime | string ( Timestamp format) Только вывод. Время, когда истечет срок действия доступа к этому сеансу (и выбранным в нем элементам мультимедиа). Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" . |
mediaItemsSet | boolean Только вывод. Если установлено значение true , для этого сеанса были выбраны элементы мультимедиа, и ваше приложение может запросить список выбранных элементов мультимедиа через mediaItems.list . |
Конфигурация опроса
Конфигурация для опроса API.
JSON-представление |
---|
{
"pollInterval": string,
"timeoutIn": string
} |
Поля |
---|
pollInterval | string ( Duration format) Только вывод. Рекомендуемое время между запросами на опрос. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
timeoutIn | string ( Duration format) Только вывод. Промежуток времени, по истечении которого клиент должен прекратить опрос. Значение 0 указывает, что клиент должен прекратить опрос, если он еще этого не сделал. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
Методы |
---|
| Создает новый сеанс, во время которого пользователь может выбирать фотографии и видео для доступа третьих лиц. |
| Удаляет указанный сеанс. |
| Получает информацию об указанном сеансе. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-08 UTC.
[null,null,["Последнее обновление: 2025-01-08 UTC."],[[["Google Photos Picker API provides sessions for users to select photos and videos."],["`PickingSession` resource represents the user's selection session, including a URI to redirect users to Google Photos for picking media."],["Applications can poll the API using the recommended `PollingConfig` to check for session updates and retrieve selected media items."],["Sessions have an expiration time and can be programmatically created, retrieved, and deleted using the API methods."]]],["A `PickingSession` represents a user's photo/video selection process in Google Photos, identified by a unique ID. It provides a `pickerUri` to direct users to Google Photos for media selection. `PollingConfig` defines API polling parameters with `pollInterval` and `timeoutIn`. A session expires at a specified `expireTime`, after which access ends. Once `mediaItemsSet` is true, selected media can be requested. Methods allow to `create`, `get` and `delete` sessions.\n"]]