이 페이지는 Cloud Translation API를 통해 번역되었습니다.

사용자 검색

Directory API의 users.list() 메서드를 사용하여 특정 속성과 일치하는 사용자를 검색할 수 있습니다. 이 메서드는 하나 이상의 검색 절을 결합한 검색 쿼리인 query 매개변수를 허용합니다. 각 검색 조건은 다음 세 부분으로 구성됩니다.

필드: 검색되는 사용자 속성입니다. 예를 들면 givenName입니다.
연산자: 데이터에 대해 실행되어 일치를 제공하는 테스트입니다. 예를 들어 : 연산자는 텍스트 속성에 값이 포함되는지 테스트합니다.
값: 테스트되는 속성의 콘텐츠입니다. 예를 들면 Jane입니다.

쿼리에서 여러 필드를 검색하려면 각 검색 절을 공백으로 구분하여 추가합니다. 이 작업은 암시적 AND입니다.

필드

필드	값 유형	연산자	설명
지정되지 않음	문자열		`givenName`, `familyName` 또는 `email`의 값과 비교합니다.
`name`	문자열	`=, :`	`givenName` 및 `familyName`의 연결된 값입니다.
`email`	문자열	`=`, `:`, `:{PREFIX}*`	사용자의 이메일 주소(별칭 포함)
`givenName`	문자열	`=`, `:`, `:{PREFIX}*`	사용자의 이름입니다.
`familyName`	문자열	`=`, `:`, `:{PREFIX}*`	사용자의 성 또는 가족 이름입니다.
`isAdmin`	부울	`=`	사용자에게 최고 관리자 권한이 있는지 여부입니다.
`isDelegatedAdmin`	부울	`=`	사용자가 관리자 권한을 위임받았는지 여부입니다.
`isSuspended`	부울	`=`	사용자 계정이 정지되었는지 여부입니다.
`isArchived`	부울	`=`	사용자의 계정이 보관처리되었는지 여부입니다.
`im`	문자열	`=, :`	IM 네트워크 ID입니다.
`externalId`	문자열	`=, :`	외부 ID 값입니다.
`manager`	문자열	`=`	사용자의 관리자 이메일 주소(직접 또는 관리 체인 위)입니다.
`managerId`	문자열	`=`	사용자의 관리자의 ID로, 관리 체인에서 직속 상위 관리자의 ID일 수도 있고 그 위의 관리자의 ID일 수도 있습니다.
`directManager`	문자열	`=`	사용자의 직속 관리자의 이메일 주소입니다.
`directManagerId`	문자열	`=`	사용자의 직속 관리자의 ID입니다.
`address`	문자열	`:`	모든 주소 필드와 일치합니다.
`addressPoBox`	문자열	`=, :`	사서함입니다.
`addressExtended`	문자열	`=, :`	하위 지역을 포함하는 주소와 같은 확장된 주소입니다.
`addressStreet`	문자열	`=, :`	상세 주소입니다.
`addressLocality`	문자열	`=, :`	주소의 마을 또는 도시입니다.
`addressRegion`	문자열	`=, :`	약어로 표시된 도 또는 주입니다.
`addressPostalCode`	문자열	`=, :`	우편번호입니다.
`addressCountry`	문자열	`=, :`	국가입니다.
`orgName`	문자열	`=, :`	조직 이름입니다.
`orgTitle`	문자열	`=, :`	조직 내 사용자의 직함입니다.
`orgDepartment`	문자열	`=, :`	조직 내 부서입니다.
`orgDescription`	문자열	`=, :`	조직 설명입니다.
`orgCostCenter`	문자열	`=, :`	조직의 비용 센터입니다.
`phone`	문자열	`=`	사용자의 전화번호입니다.
`orgUnitPath`	문자열	`=`	조직 단위의 전체 경로입니다. 이는 타겟 아래의 모든 조직 단위 체인과 일치합니다. 예를 들어 `'orgUnitPath=/'`는 조직의 모든 사용자를 반환합니다. 이 필드는 `viewType=admin_view`인 경우에만 사용할 수 있습니다.
`isEnrolledIn2Sv`	부울	`=`	사용자가 2단계 인증에 등록되어 있는지 여부입니다.
`isEnforcedIn2Sv`	부울	`=`	사용자에게 2단계 인증이 시행되는지를 나타냅니다.
`schemaName.fieldName`	?	?	스키마 및 필드 이름으로 참조되는 맞춤 사용자 속성입니다. 필드의 `indexed` 속성이 `true`로 설정되어야 합니다.

값 유형

값 유형	등가 스키마 fieldType	참고
문자열	`STRING`, `EMAIL`, `PHONE`	쿼리에 공백이 포함된 경우 작은따옴표 `'`로 묶습니다. 쿼리에서 작은따옴표를 `\'`로 이스케이프 처리합니다(예: `'Valentine\'s Day'`).
부울	`BOOL`	값은 `true` 또는 `false`여야 합니다. `=` 연산자만 지원합니다.
숫자	`INT64`, `DOUBLE`	소수점 구분 기호로 마침표를 사용하고 천 단위 구분 기호는 사용하면 안 됩니다(예: `150430.25`).
날짜	`DATE`	YYYY-MM-DD 형식으로 지정됩니다(예: `2001-02-15`).

연산자

연산자	지원되는 값 유형	참고
`=`	문자열, 불리언, 숫자, 날짜	필드와 값이 정확하게 일치합니다. 예를 들어 `givenName=Jane`는 `givenName` 속성 `"Jane"`가 있는 모든 사용자와 일치하지만 `"Jane Ann"`와는 일치하지 않습니다. 대부분의 문자열 필드에서 지원됩니다 (위 참고).
`:`	문자열	이 필드에는 값 내의 전체 단어가 순서대로 포함됩니다. 예를 들어 `givenName:Jane`가 포함된 쿼리는 `givenName` 값이 `"Jane"` 및 `"Jane Ann"`인 사용자와 일치하지만 `"Janet"`와는 일치하지 않습니다. `'givenName:Mary Ann'`에 대한 여러 단어 쿼리는 `"Mary Ann Evans"` 및 `"Sarah Mary Ann"` 값과 일치하지만 `"Ann Mary"` 값과는 일치하지 않습니다. 대부분의 문자열 필드에서 지원됩니다 (위 참고).
`:{PREFIX}*`	문자열	필드는 값으로 시작합니다. 예를 들어 `givenName:Jane*`가 포함된 쿼리는 `givenName` 값이 `"Jane"`, `"Jane Ann"`, `"Janet"`인 사용자와 일치하지만 `"Sarah Jane"`와는 일치하지 않습니다. 제한된 문자열 필드에서만 지원됩니다 (위 참고). 맞춤 속성에는 지원되지 않습니다.
`:[{MIN},{MAX}]`	number, date	필드가 범위 내에 있습니다. 일치하려면 필드의 값이 `{MIN}` 이상이고 `{MAX}`보다 작아야 합니다. 이 연산자를 지원하려면 맞춤 숫자 속성이 `numericIndexingSpec`을 지정해야 합니다.
`>`	number, date	필드가 값보다 큽니다. 이 연산자를 지원하려면 맞춤 숫자 속성이 `numericIndexingSpec`을 지정해야 합니다.
`>=`	number, date	필드가 값보다 크거나 같습니다. 이 연산자를 지원하려면 맞춤 숫자 속성이 `numericIndexingSpec`을 지정해야 합니다.
`<`	number, date	필드가 값보다 작습니다. 이 연산자를 지원하려면 맞춤 숫자 속성이 `numericIndexingSpec`을 지정해야 합니다.
`<=`	number, date	필드가 값보다 작거나 같습니다. 이 연산자를 지원하려면 맞춤 숫자 속성이 `numericIndexingSpec`을 지정해야 합니다.

예

모든 쿼리는 다음과 유사한 HTTP 요청이 있는 users.list 메서드를 사용합니다 (가독성을 위해 줄바꿈 포함).

GET https://admin.googleapis.com/admin/directory/v1/users?domain=DOMAIN_NAME&query=QUERY_PARAMETERS

이름으로 사용자 검색

name 쿼리 필드는 givenName 및 familyName의 연결된 값을 테스트합니다. name='Jane'에 대한 검색어는 givenName='Jane' 및 familyName='Smith'가 있는 사용자에게 결과를 반환하지 않습니다.

name='Jane Smith'

값이 포함된 givenName 또는 familyName가 있는 사용자 검색

name:'Jane'

이메일 접두사와 일치하는 사용자 검색하기

email:admin*

모든 최고 관리자 검색하기

isAdmin=true

orgTitles에 '관리자'가 포함된 사용자 검색

orgTitle:Manager

보고 체인에 공통 관리자가 있는 사용자 검색하기

manager='janesmith@example.com'

직접 관리자가 동일한 사용자 검색하기

directManager='bobjones@example.com'

특정 국가의 사용자 검색하기

addressCountry='Sweden'

특정 조직의 사용자 검색하기

orgName='Human Resources'

특정 조직의 관리자 검색하기

orgName=Engineering orgTitle:Manager

맞춤 사용자 속성 검색하기

특정 프로젝트에서 근무하는 모든 직원 검색하기

EmploymentData.projects:'GeneGnomes'

특정 위치의 모든 직원 검색하기

EmploymentData.location='Atlanta'

직무 수준 7 이상의 모든 직원 검색하기

EmploymentData.jobLevel>=7

직무 수준이 5 이상 8 미만인 모든 직원 검색

EmploymentData.jobLevel:[5,8]

2단계 인증에 등록된 모든 직원 검색하기

isEnrolledIn2Sv=true

2단계 인증이 적용된 모든 직원 검색하기

isEnforcedIn2Sv=true