Admin SDK: Directory API

Admin SDK Directory API를 사용하면 엔터프라이즈 도메인의 관리자가 조직의 사용자, 그룹, 기기, 관련 리소스를 보고 관리할 수 있습니다. Cloud ID 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}
ChromeOS 기기의 속성을 검색합니다.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
계정 내에서 페이지로 나눈 Chrome OS 기기 목록을 가져옵니다.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
여러 Chrome OS 기기를 조직 단위로 이동하거나 삽입합니다.
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
모든 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 리소스: 스키마

방법
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
지정된 사용자의 현재 유효한 백업 인증 코드 세트를 반환합니다.