Выберите области действия API настроек администратора
Этот документ содержит информацию об авторизации и аутентификации, специфичную для API настроек администратора. Прежде чем читать этот документ, обязательно прочтите общую информацию об аутентификации и авторизации Google Workspace в разделе Подробнее об аутентификации и авторизации .
Настройте OAuth 2.0 для авторизации
Настройте экран согласия OAuth и выберите области, чтобы определить, какая информация будет отображаться пользователям и рецензентам приложений, а также зарегистрируйте свое приложение, чтобы можно было опубликовать его позже.
Области API настроек администратора
Чтобы определить уровень доступа, предоставленный вашему приложению, вам необходимо определить и объявить области авторизации . Область авторизации – это строка URI OAuth 2.0, содержащая имя приложения Google Workspace, тип данных, к которым оно обращается, и уровень доступа. Области – это запросы вашего приложения на работу с данными Google Workspace, включая данные аккаунтов Google пользователей.
Когда ваше приложение установлено, пользователю предлагается проверить области, используемые приложением. Как правило, вам следует выбирать максимально узконаправленную область действия и избегать запроса областей, которые не требуются вашему приложению. Пользователи с большей готовностью предоставляют доступ к ограниченным, четко описанным областям.
API настроек администратора поддерживает следующие области:
Области применения
Значение
https://apps-apis.google.com/a/feeds/domain/
Глобальная область доступа ко всем настройкам домена.
[null,null,["Последнее обновление: 2024-11-19 UTC."],[[["This document provides authorization and authentication details specifically for the Admin Settings API within Google Workspace."],["Before using this API, review Google Workspace's general authentication and authorization guidelines."],["Configure OAuth 2.0 including the consent screen and scopes to manage user data access for your app."],["Choose the most restrictive scopes necessary for your application's functionality to foster user trust."],["The Admin Settings API utilizes specific scopes, like `https://apps-apis.google.com/a/feeds/domain/`, to define access levels to domain settings."]]],["To access the Admin Settings API, configure OAuth 2.0 by setting up the consent screen and selecting authorization scopes, which define the level of data access. Scopes are OAuth 2.0 URI strings specifying the Google Workspace app, data type, and access level. Choose the narrowest scopes necessary for your app. Public apps using sensitive data-accessing scopes must undergo a verification process. The Admin Settings API supports one scope: `https://apps-apis.google.com/a/feeds/domain/` for global domain settings access.\n"]]
