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 리소스로 표시됩니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Directory API Overview\n\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Directory API is part of the RESTful Admin SDK API that can be used to\nprogrammatically create and manage admin-controlled resources owned by a\nGoogle Workspace account. Some use cases include:\n\n- Creating and managing users and adding administrators.\n- Creating and managing groups and group memberships.\n- Monitoring devices connected to your domain and taking action on lost devices.\n- Managing your org chart and organization structures.\n- Auditing applications your users have granted access to and revoking unauthorized apps.\n\nFollowing is a list of common terms used in the Directory API:\n\n*Customer*\n: The entity that owns the Google Workspace account, represented by the\n [Customer](/workspace/admin/directory/reference/rest/v1/customers) resource.\n\n*Domain*\n: If applicable, the DNS domain associated with a Google Workspace account,\n represented by the\n [Domain](/workspace/admin/directory/reference/rest/v1/domains) resource. Not all\n accounts have an associated domain.\n\n*Organizational unit (OU)*\n: A sub-unit of a Google Workspace account's organizational tree, used to\n group and sort users for the purpose of applying policies and granting\n authorizations. An OU is represented by the\n [OrgUnit](/workspace/admin/directory/reference/rest/v1/orgunits) resource.\n\n*Privilege*\n: The ability of a user to perform an action on a Google Workspace resource.\n Applies primarily to admins. A privilege is represented by the\n [Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)\n resource.\n\n*Role*\n: A defined collection of privileges that can be assigned to a user or set of\n users, represented by the\n [Role](/workspace/admin/directory/reference/rest/v1/roles) resource.\n\n*Role assignment*\n: A record indicating which user is granted what roles, and over what scope.\n A role assignment is represented by the\n [RoleAssignment](/workspace/admin/directory/reference/rest/v1/roleAssignments)\n resource.\n\n*Schema*\n: A JSON object that defines custom user attributes for your organization,\n represented by the\n [Schema](/workspace/admin/directory/reference/rest/v1/schemas) resource.\n\n*User*\n: An individual end user account with access to Google Workspace apps and\n resources, represented by the\n [User](/workspace/admin/directory/reference/rest/v1/users) resource.\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Directory API app, try the\n [JavaScript quickstart](/workspace/admin/directory/v1/quickstart/js)."]]
