Этот документ содержит информацию об авторизации и аутентификации, специфичную для API Google Таблиц. Перед прочтением этого документа обязательно ознакомьтесь с общей информацией об аутентификации и авторизации в Google Workspace в разделе «Узнайте об аутентификации и авторизации» .
Обратите внимание, что области действия API Таблиц применяются к файлу электронной таблицы и не могут быть ограничены конкретным листом . Чтобы предотвратить изменение листа, используйте ProtectedRange для определения ячейки или диапазона ячеек, которые нельзя редактировать. Пример см. в разделе Именованные и защищенные диапазоны .
Настройте OAuth 2.0 для авторизации
Настройте экран согласия OAuth и выберите области действия , чтобы определить, какая информация будет отображаться пользователям и рецензентам приложения, а также зарегистрируйте свое приложение, чтобы вы могли опубликовать его позже.
Области применения API Таблиц
Чтобы определить уровень доступа, предоставляемый вашему приложению, необходимо определить и объявить области авторизации . Область авторизации — это строка URI OAuth 2.0, содержащая название приложения Google Workspace, тип данных, к которым оно получает доступ, и уровень доступа. Области авторизации — это запросы вашего приложения на работу с данными Google Workspace, включая данные учётных записей Google пользователей.
При установке вашего приложения пользователю предлагается подтвердить используемые им области действия. Как правило, следует выбирать максимально узкую область действия и избегать запроса областей действия, которые не требуются вашему приложению. Пользователи охотнее предоставляют доступ к ограниченным, чётко описанным областям действия.
По возможности мы рекомендуем использовать неконфиденциальные области, поскольку это обеспечивает область доступа к каждому файлу и сужает доступ к определенным функциям, необходимым приложению.
API Таблиц поддерживает следующие области действия:
| Код области действия | Описание | Использование |
|---|---|---|
https://www.googleapis.com/auth/spreadsheets | Просматривайте, редактируйте, создавайте и удаляйте все свои таблицы Google Sheets. | Чувствительный |
https://www.googleapis.com/auth/spreadsheets.readonly | Просматривайте все свои таблицы Google. | Чувствительный |
https://www.googleapis.com/auth/drive.file | Просматривайте, редактируйте, создавайте и удаляйте только те файлы Google Диска, которые вы используете с этим приложением. | Рекомендуется Нечувствительный |
https://www.googleapis.com/auth/drive | Просматривайте, редактируйте, создавайте и удаляйте все ваши файлы на Google Диске. | Ограниченный |
https://www.googleapis.com/auth/drive.readonly | Просматривайте и загружайте все ваши файлы на Google Диске. | Ограниченный |
Столбец «Использование» в таблице указывает чувствительность каждой области в соответствии со следующими определениями:
Неконфиденциальные : эти области предоставляют минимальный доступ к авторизации и требуют только базовой проверки приложения. Подробнее об этом требовании см. в разделе «Отправка приложения на проверку» .
Конфиденциальные : эти области предоставляют доступ к определённым данным пользователя Google, которые он авторизовал для вашего приложения. Для этого требуется дополнительная проверка приложения. Подробнее об этом требовании см. в разделе «Требования к конфиденциальным и ограниченным областям» .
Ограниченный доступ : эти области предоставляют широкий доступ к пользовательским данным Google и требуют прохождения процедуры проверки ограниченной области действия. Подробнее об этом требовании см. в разделе «Политика в отношении пользовательских данных сервисов API Google» и «Дополнительные требования к конкретным областям действия API» . Если вы храните (или передаете) данные ограниченной области действия на серверах, вам необходимо пройти оценку безопасности.
Если вашему приложению требуется доступ к другим API Google, вы также можете добавить эти области действия. Подробнее об областях действия API Google см. в статье «Использование OAuth 2.0 для доступа к API Google» .
Дополнительную информацию о конкретных областях действия OAuth 2.0 см. в разделе Области действия OAuth 2.0 для API Google .
Похожие темы
- Выберите области действия API Google Drive
- Справочный центр проверки приложений OAuth
- Часто задаваемые вопросы о проверке приложений OAuth