Directory API 개요

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

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

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

고객
Google Workspace 계정을 소유한 항목으로, 고객 리소스로 표시됩니다.
도메인
해당하는 경우 Google Workspace 계정과 연결된 DNS 도메인으로, 도메인 리소스로 표시됩니다. 모든 계정에 연결된 도메인이 있는 것은 아닙니다.
조직 단위 (OU)
Google Workspace 계정 조직 트리의 하위 단위로, 정책 적용 및 승인 부여를 위해 사용자를 그룹화하고 정렬하는 데 사용됩니다. OU는 OrgUnit 리소스로 표현됩니다.
권한
사용자가 Google Workspace 리소스에서 작업을 수행할 수 있는 기능입니다. 주로 관리자에게 적용됩니다. 권한은 권한 리소스로 표현됩니다.
역할
사용자 또는 사용자 집합에 할당할 수 있는 정의된 권한 모음으로, 역할 리소스로 표시됩니다.
역할 할당
어떤 사용자에게 어떤 역할이 부여되었는지를 나타내는 레코드입니다. 역할 할당은 RoleAssignment 리소스로 표시됩니다.
스키마
조직의 커스텀 사용자 속성을 정의하는 JSON 객체로, 스키마 리소스로 표현됩니다.
사용자(User)
Google Workspace 앱 및 리소스에 대한 액세스 권한이 있는 개별 최종 사용자 계정으로, 사용자 리소스로 표시됩니다.

다음 단계

  • 인증 및 승인 처리를 포함하여 Google Workspace API를 사용한 개발에 대해 자세히 알아보려면 Workspace 개발자로 시작하기를 참조하세요.

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