API Google Photos содержат несколько областей, используемых для доступа к элементам мультимедиа и альбомам. Ответы, возвращаемые различными вызовами, различаются в зависимости от того, какие области были запрошены разработчиком.
Каждый запрос, который ваше приложение отправляет к API Google Фото, должен включать токен авторизации. Токен также идентифицирует ваше приложение для Google.
О протоколах авторизации
Ваше приложение должно использовать OAuth 2.0 для авторизации запросов. Никакие другие протоколы авторизации не поддерживаются. Если ваше приложение использует «Войти через Google» , некоторые аспекты авторизации выполняются за вас.
Авторизация запросов с помощью OAuth 2.0
Все запросы к API Google Фото должны быть авторизованы авторизованным пользователем.
Детали процесса авторизации или «потока» для OAuth 2.0 несколько различаются в зависимости от того, какое приложение вы пишете. Следующий общий процесс применим ко всем типам приложений:
- Когда вы создаете свое приложение, вы регистрируете его с помощью консоли Google API . Затем Google предоставляет информацию, которая понадобится вам позже, например идентификатор клиента и секрет клиента.
- Активируйте API Google Photos в консоли Google API. (Если API не указан в консоли API, пропустите этот шаг.)
- Когда вашему приложению требуется доступ к пользовательским данным, оно запрашивает у Google определенный объем доступа.
- Google отображает пользователю экран согласия , прося его разрешить вашему приложению запрашивать некоторые его данные.
- Если пользователь одобряет, Google предоставляет вашему приложению кратковременный токен доступа .
- Ваше приложение запрашивает пользовательские данные, прикрепляя к запросу токен доступа.
- Если Google определит, что ваш запрос и токен действительны, он вернет запрошенные данные.
Некоторые потоки включают дополнительные шаги, например использование токенов обновления для получения новых токенов доступа. Подробную информацию о потоках для различных типов приложений см. в документации Google OAuth 2.0 .
Ниже представлена информация об области действия OAuth 2.0 для API Google Photos:
Области API средства выбора
| Объем | Значение |
|---|---|
https://www.googleapis.com/auth/photospicker.mediaitems.readonly | Доступ для создания, получения и удаления сеансов, а также для вывода списка мультимедийных элементов для сеансов. |
Области API библиотеки
| Объем | Значение |
|---|---|
https://www.googleapis.com/auth/photoslibrary.readonlyhttps://www.googleapis.com/auth/photoslibrary.sharinghttps://www.googleapis.com/auth/photoslibrary | |
https://www.googleapis.com/auth/photoslibrary.appendonly | Доступ для загрузки байтов, создания мультимедийных элементов, создания альбомов и добавления дополнений. Разрешает создание новых медиафайлов только в библиотеке пользователя и в альбомах, созданных приложением. |
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata | Доступ для чтения к медиа-элементам и альбомам, созданным разработчиком. Дополнительные сведения см. в разделах Доступ к элементам мультимедиа и Просмотр содержимого библиотеки, альбомов и элементов мультимедиа . Предназначен для запроса вместе с областью |
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata | Доступ только для редактирования. Доступ для изменения этих данных для альбомов и медиа-элементов, созданных разработчиком:
|
Чтобы запросить доступ с помощью OAuth 2.0, вашему приложению необходима информация об области действия, а также информация, которую Google предоставляет при регистрации вашего приложения (например, идентификатор клиента и секрет клиента).
Совет: Клиентские библиотеки API Google могут выполнить за вас часть процесса авторизации. Они доступны для различных языков программирования; проверьте страницу с библиотеками и образцами для получения более подробной информации.
Выбор областей
Как правило, выбирайте максимально ограниченную область действия и избегайте запроса областей, которые не нужны вашему приложению. Пользователи с большей готовностью предоставляют доступ к ограниченным, четко описанным областям. Пользователи могут колебаться в предоставлении широкого доступа к своим медиа, если они не доверяют вашему приложению и не понимают, зачем ему нужна информация.
Постепенно запрашиваемые области
Следуя рекомендациям по авторизации, ваше приложение должно запрашивать области только по мере необходимости. Не запрашивайте все области вашего приложения заранее при входе в систему. Вместо этого предоставьте обоснование и сделайте запрос в контексте. Четко объясните, что вы будете делать с данными своих пользователей и какую выгоду они получат от предоставления доступа в соответствии с рекомендациями по пользовательскому интерфейсу и лучшими практиками направления уведомлений и запроса согласия.
Сервисные аккаунты
API Google Фото не поддерживают сервисные аккаунты. Ваше приложение должно использовать другие доступные потоки OAuth 2.0, такие как OAuth 2.0 для приложений веб-сервера или OAuth 2.0 для мобильных и настольных приложений .