API каталога является частью API RESTful Admin SDK, который можно использовать для программного создания и управления ресурсами, контролируемыми администратором и принадлежащими учетной записи Google Workspace. Примеры использования:
- Создание и управление пользователями, а также добавление администраторов.
- Создание и управление группами и членством в группах.
- Мониторинг устройств, подключенных к вашему домену, и принятие мер в случае потери устройств.
- Управление организационной структурой и схемой вашей компании.
- Проведение аудита приложений, к которым ваши пользователи предоставили доступ, и аннулирование несанкционированных приложений.
Ниже приведён список распространённых терминов, используемых в API каталога:
- Клиент
- Субъект, которому принадлежит учетная запись Google Workspace, представлен ресурсом Customer .
- Домен
- Если применимо, DNS-домен, связанный с учетной записью Google Workspace, представленный ресурсом Domain . Не все учетные записи имеют связанный домен.
- Организационная единица (ОЕ)
- Подразделение организационной структуры учетной записи Google Workspace, используемое для группировки и сортировки пользователей с целью применения политик и предоставления разрешений. Организационное подразделение представлено ресурсом OrgUnit .
- Привилегия
- Возможность пользователя выполнять действия с ресурсом Google Workspace. Применяется в основном к администраторам. Привилегия представлена ресурсом Privilege .
- Роль
- Определенный набор привилегий, которые могут быть назначены пользователю или группе пользователей, представленный ресурсом «Роль» .
- Назначение ролей
- Запись, указывающая, какому пользователю предоставлены какие роли и в каком объеме. Назначение ролей представлено ресурсом RoleAssignment .
- Схема
- JSON-объект, определяющий пользовательские атрибуты для вашей организации, представленный ресурсом Schema .
- Пользователь
- Индивидуальная учетная запись пользователя с доступом к приложениям и ресурсам Google Workspace, представленная ресурсом «Пользователь» .
Следующие шаги
Чтобы узнать о разработке с использованием API Google Workspace, включая обработку аутентификации и авторизации, обратитесь к разделу «Начало работы в качестве разработчика Workspace» .
Чтобы узнать, как настроить и запустить приложение Directory API, воспользуйтесь руководством по быстрому запуску JavaScript .