Admin SDK: Directory API

Admin SDK Directory API를 사용하면 엔터프라이즈 도메인의 관리자가 조직의 사용자, 그룹, 기기, 관련 리소스를 보고 관리할 수 있습니다. Cloud Identity API는 동일한 리소스의 일부를 관리하는 추가 방법을 제공합니다.

서비스: admin.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

검색 문서

검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://admin.googleapis.com

REST 리소스: asps

메서드
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
사용자가 발급한 ASP를 삭제합니다.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
사용자가 발급한 ASP에 대한 정보를 가져옵니다.
list GET /admin/directory/v1/users/{userKey}/asps
사용자가 발급한 ASP를 나열합니다.

REST 리소스: chromeosdevices

메서드
action
(deprecated)		 POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
대신 BatchChangeChromeOsDeviceStatus를 사용하세요.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Chrome OS 기기의 속성을 가져옵니다.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
계정 내 Chrome OS 기기의 페이지로 나뉜 목록을 가져옵니다.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
여러 ChromeOS 기기를 조직 단위로 이동하거나 삽입합니다.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
기기의 업데이트 가능한 속성(예: annotatedUser, annotatedLocation, notes, orgUnitPath, annotatedAssetId)을 업데이트합니다.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
기기의 업데이트 가능한 속성(예: annotatedUser, annotatedLocation, notes, orgUnitPath, annotatedAssetId)을 업데이트합니다.

REST 리소스: customer.devices.chromeos

메서드
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
ChromeOS 기기 일괄의 상태를 변경합니다.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
기기가 실행할 명령어를 실행합니다.

REST 리소스: customer.devices.chromeos.commands

메서드
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
기기에 실행된 특정 명령어의 명령어 데이터를 가져옵니다.

REST 리소스: customers

메서드
get GET /admin/directory/v1/customers/{customerKey}
고객을 검색합니다.
patch PATCH /admin/directory/v1/customers/{customerKey}
고객에 패치를 적용합니다.
update PUT /admin/directory/v1/customers/{customerKey}
고객을 업데이트합니다.

REST 리소스: domainAliases

메서드
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
고객의 도메인 별칭을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
고객의 도메인 별칭을 검색합니다.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
고객의 도메인 별칭을 삽입합니다.
list GET /admin/directory/v1/customer/{customer}/domainaliases
고객의 도메인 별칭을 표시합니다.

REST 리소스: domains

메서드
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
고객의 도메인을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
고객의 도메인을 가져옵니다.
insert POST /admin/directory/v1/customer/{customer}/domains
고객의 도메인을 삽입합니다.
list GET /admin/directory/v1/customer/{customer}/domains
고객의 도메인을 나열합니다.

REST 리소스: groups

메서드
delete DELETE /admin/directory/v1/groups/{groupKey}
그룹을 삭제합니다.
get GET /admin/directory/v1/groups/{groupKey}
그룹의 속성을 검색합니다.
insert POST /admin/directory/v1/groups
그룹을 만듭니다.
list GET /admin/directory/v1/groups
userKey가 주어진 도메인 또는 사용자의 모든 그룹을 검색합니다 (페이징됨).
patch PATCH /admin/directory/v1/groups/{groupKey}
그룹의 속성을 업데이트합니다.
update PUT /admin/directory/v1/groups/{groupKey}
그룹의 속성을 업데이트합니다.

REST 리소스: groups.aliases

메서드
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
별칭을 삭제합니다.
insert POST /admin/directory/v1/groups/{groupKey}/aliases
그룹의 별칭을 추가합니다.
list GET /admin/directory/v1/groups/{groupKey}/aliases
그룹의 모든 별칭을 나열합니다.

REST 리소스: members

메서드
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
그룹에서 구성원을 삭제합니다.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
그룹 구성원의 속성을 검색합니다.
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
지정된 사용자가 그룹의 구성원인지 확인합니다.
insert POST /admin/directory/v1/groups/{groupKey}/members
지정된 그룹에 사용자를 추가합니다.
list GET /admin/directory/v1/groups/{groupKey}/members
그룹의 모든 구성원 목록을 페이지로 나눈 목록으로 가져옵니다.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
지정된 그룹의 사용자 멤버십 속성을 업데이트합니다.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
지정된 그룹의 사용자 멤버십을 업데이트합니다.

REST 리소스: mobiledevices

메서드
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
휴대기기에 영향을 미치는 작업을 실행합니다.
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
휴대기기를 삭제합니다.
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
휴대기기의 속성을 검색합니다.
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
계정의 모든 사용자 소유 휴대기기의 페이징된 목록을 검색합니다.

REST 리소스: orgunits

메서드
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
조직 단위를 삭제합니다.
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
조직 단위를 검색합니다.
insert POST /admin/directory/v1/customer/{customerId}/orgunits
조직 단위를 추가합니다.
list GET /admin/directory/v1/customer/{customerId}/orgunits
계정의 모든 조직 단위 목록을 가져옵니다.
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
조직 단위를 업데이트합니다.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
조직 단위를 업데이트합니다.

REST 리소스: privileges

메서드
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
고객의 모든 권한 목록을 페이지로 나눈 형식으로 가져옵니다.

REST 리소스: resources.buildings

메서드
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
건물을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
건물을 검색합니다.
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
건물을 삽입합니다.
list GET /admin/directory/v1/customer/{customer}/resources/buildings
계정의 건물 목록을 가져옵니다.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
건물에 패치를 적용합니다.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
건물을 업데이트합니다.

REST 리소스: resources.calendars

메서드
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
캘린더 리소스를 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
캘린더 리소스를 가져옵니다.
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
캘린더 리소스를 삽입합니다.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
계정의 캘린더 리소스 목록을 검색합니다.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
캘린더 리소스를 패치합니다.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
캘린더 리소스를 업데이트합니다.

REST 리소스: resources.features

메서드
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
특성을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
특성을 검색합니다.
insert POST /admin/directory/v1/customer/{customer}/resources/features
지형지물을 삽입합니다.
list GET /admin/directory/v1/customer/{customer}/resources/features
계정의 기능 목록을 가져옵니다.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
지형지물에 패치를 적용합니다.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
지형지물의 이름을 바꿉니다.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
지형지물을 업데이트합니다.

REST 리소스: roleAssignments

메서드
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
역할 할당을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
역할 할당을 검색합니다.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
역할 할당을 만듭니다.
list GET /admin/directory/v1/customer/{customer}/roleassignments
모든 역할 할당의 페이징된 목록을 검색합니다.

REST 리소스: roles

메서드
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
역할을 삭제합니다.
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
역할을 검색합니다.
insert POST /admin/directory/v1/customer/{customer}/roles
역할 만들기
list GET /admin/directory/v1/customer/{customer}/roles
도메인의 모든 역할 목록을 페이지로 나눈 형식으로 가져옵니다.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
역할을 패치합니다.
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
역할을 업데이트합니다.

REST 리소스: schemas

메서드
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
스키마를 삭제합니다.
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
스키마를 검색합니다.
insert POST /admin/directory/v1/customer/{customerId}/schemas
스키마를 만듭니다.
list GET /admin/directory/v1/customer/{customerId}/schemas
고객의 모든 스키마를 검색합니다.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
스키마에 패치를 적용합니다.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
스키마를 업데이트합니다.

REST 리소스: tokens

메서드
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
사용자가 애플리케이션에 대해 발급한 모든 액세스 토큰을 삭제합니다.
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
사용자가 발급한 액세스 토큰에 관한 정보를 가져옵니다.
list GET /admin/directory/v1/users/{userKey}/tokens
지정된 사용자가 서드 파티 애플리케이션에 발급한 토큰 집합을 반환합니다.

REST 리소스: twoStepVerification

메서드
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
사용자의 2단계 인증을 사용 중지합니다.

REST 리소스: users

메서드
delete DELETE /admin/directory/v1/users/{userKey}
사용자를 삭제합니다.
get GET /admin/directory/v1/users/{userKey}
사용자를 검색합니다.
insert POST /admin/directory/v1/users
사용자를 만듭니다.
list GET /admin/directory/v1/users
삭제된 사용자 또는 도메인의 모든 사용자 목록을 페이징하여 가져옵니다.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
사용자를 최고 관리자로 지정합니다.
patch PATCH /admin/directory/v1/users/{userKey}
패치 시맨틱스를 사용하여 사용자를 업데이트합니다.
signOut POST /admin/directory/v1/users/{userKey}/signOut
모든 웹 및 기기 세션에서 사용자를 로그아웃하고 로그인 쿠키를 재설정합니다.
undelete POST /admin/directory/v1/users/{userKey}/undelete
삭제된 사용자를 복구합니다.
update PUT /admin/directory/v1/users/{userKey}
사용자를 업데이트합니다.
watch POST /admin/directory/v1/users/watch
사용자 목록의 변경사항을 감시합니다.

REST 리소스: users.aliases

메서드
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
별칭을 삭제합니다.
insert POST /admin/directory/v1/users/{userKey}/aliases
별칭을 추가합니다.
list GET /admin/directory/v1/users/{userKey}/aliases
사용자의 모든 별칭을 나열합니다.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
사용자 목록의 변경사항을 감시합니다.

REST 리소스: users.photos

메서드
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
사용자의 사진을 삭제합니다.
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
사용자의 사진을 검색합니다.
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
사용자의 사진을 추가합니다.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
사용자의 사진을 추가합니다.

REST 리소스: verificationCodes

메서드
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
사용자의 새 백업 인증 코드를 생성합니다.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
사용자의 현재 백업 인증 코드를 무효화합니다.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
지정된 사용자의 현재 유효한 백업 인증 코드 집합을 반환합니다.