REST Resource: orgunits

리소스: OrgUnit

계정의 조직 단위를 관리하면 서비스 및 맞춤 설정에 대한 사용자의 액세스를 구성할 수 있습니다. 일반적인 조직 단위 작업에 관한 자세한 내용은 개발자 가이드를 참고하세요. 고객의 조직 단위 계층 구조는 35개 수준으로 제한됩니다.

JSON 표현
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
입력란
kind

string

API 리소스의 유형입니다. 조직 단위 리소스의 경우 값은 admin#directory#orgUnit입니다.

name

string

조직 단위의 경로 이름입니다. 예를 들어 /corp/support/sales_support 상위 경로 내의 조직 단위 이름은 sales_support입니다. 필수 항목입니다.

description

string

조직 단위의 설명입니다.

etag

string

리소스의 ETag입니다.

blockInheritance
(deprecated)

boolean

하위 조직 단위가 상위 조직의 설정을 상속할 수 있는지 결정합니다. 기본값은 false입니다. 즉, 하위 조직 단위에 가장 가까운 상위 조직 단위의 설정이 상속됩니다. 이 필드는 더 이상 사용되지 않습니다. true로 설정하는 것은 더 이상 지원되지 않으며 의도하지 않은 결과가 발생할 수 있습니다. 조직 구조의 상속 및 사용자에 대한 자세한 내용은 관리 고객센터를 참고하세요.

orgUnitId

string

조직 단위의 고유 ID입니다.

orgUnitPath

string

조직 단위의 전체 경로입니다. orgUnitPath는 파생된 속성입니다. 나열되는 경우 parentOrgunitPath 및 조직 단위의 name에서 파생됩니다. 예를 들어 상위 조직 '/engineering'에 'apps'라는 조직 단위의 경우 orgUnitPath는 '/engineering/apps'입니다. orgUnitPath를 수정하려면 조직의 이름 또는 parentOrgunitPath을 업데이트하세요.
사용자의 조직 단위에 따라 사용자가 액세스할 수 있는 Google Workspace 서비스가 결정됩니다. 사용자가 새 조직으로 이동하면 사용자의 액세스 권한이 변경됩니다. 조직 구조에 대한 자세한 내용은 관리 고객센터를 참고하세요. 사용자를 다른 조직으로 이동하는 방법에 대한 자세한 내용은 orgunits.update 사용자를 참조하세요.

parentOrgUnitId

string

상위 조직 단위의 고유 ID입니다. parentOrgUnitPath가 설정되지 않은 경우 필수입니다.

parentOrgUnitPath

string

조직 단위의 상위 경로입니다. 예를 들어 /corp/sales는 /corp/sales/sales_support 조직 단위의 상위 경로입니다. parentOrgUnitId가 설정되지 않은 경우 필수입니다.

방법

delete

조직 단위를 삭제합니다.

get

조직 단위를 검색합니다.

insert

조직 단위를 추가합니다.

list

계정의 모든 조직 단위 목록을 검색합니다.

patch

조직 단위를 업데이트합니다.

update

조직 단위를 업데이트합니다.