Directory API 개요

Directory API는 Google Workspace 계정에서 소유하고 관리자가 제어하는 리소스를 프로그래매틱 방식으로 만들고 관리하는 데 사용할 수 있는 RESTful Admin SDK API의 일부입니다. 사용 사례는 다음과 같습니다.

• 사용자 만들기 및 관리, 관리자 추가
• 그룹 및 그룹 멤버십을 만들고 관리합니다.
• 도메인에 연결된 기기를 모니터링하고 분실된 기기에 대해 조치를 취합니다.
• 조직도 및 조직 구조 관리
• 사용자가 액세스 권한을 부여한 애플리케이션을 감사하고 승인되지 않은 앱을 취소합니다.

다음은 Directory API에서 사용되는 일반적인 용어 목록입니다.

고객

Google Workspace 계정을 소유한 법인으로, 고객 리소스로 표시됩니다.

도메인

해당하는 경우 Google Workspace 계정과 연결된 DNS 도메인으로, Domain 리소스로 표시됩니다. 일부 계정에는 연결된 도메인이 없습니다.

조직 단위 (OU)

정책을 적용하고 승인을 부여하기 위해 사용자를 그룹화하고 정렬하는 데 사용되는 Google Workspace 계정의 조직 트리 하위 단위입니다. OU는 OrgUnit 리소스로 표현됩니다.

권한

사용자가 Google Workspace 리소스에 대해 작업을 수행할 수 있는 기능입니다. 주로 관리자에게 적용됩니다. 권한은 Privilege 리소스로 표현됩니다.

직책

사용자 또는 사용자 집합에 할당할 수 있는 정의된 권한 모음으로, 역할 리소스로 표시됩니다.

역할 할당

어떤 사용자에게 어떤 역할이 어떤 범위로 부여되었는지를 나타내는 기록입니다. 역할 할당은 RoleAssignment 리소스로 표시됩니다.

스키마

Schema 리소스로 표시되는 조직의 맞춤 사용자 속성을 정의하는 JSON 객체입니다.

사용자

Google Workspace 앱 및 리소스에 액세스할 수 있는 개별 최종 사용자 계정으로, User 리소스로 표시됩니다.

다음 단계

• 인증 및 승인 처리를 비롯한 Google Workspace API를 사용한 개발에 대해 알아보려면 Workspace 개발자 시작하기를 참고하세요.

• 간단한 Directory API 앱을 구성하고 실행하는 방법을 알아보려면 JavaScript 빠른 시작을 사용해 보세요.