동적 그룹의 멤버십 쿼리 만들기

Google 관리 콘솔에서 동적 그룹의 멤버십 쿼리를 만들려는 경우 기본 표준 속성, 사용자가 생성한 맞춤 속성 또는 둘 다를 사용할 수 있습니다.

이 페이지의 내용

표준 속성 사용

관리 콘솔에서 동적 그룹을 만들 때 조건 목록에서 표준 속성을 선택합니다. 다음 표의 모든 속성을 사용하여 동적 그룹의 멤버십 쿼리를 만들 수 있습니다.

속성

샘플 코드

국가

addresses.country

user.addresses.exists(address, address.country == '캐나다')

국가 코드

addresses.country_code

user.addresses.exists(address, address.country_code == '555')

맞춤 주소 유형

addresses.custom_type

user.addresses.exists(address, address.custom_type=='맞춤 주소 유형')

확장 주소

addresses.extended_address

user.addresses.exists(address, address.extended_address=='미국 캘리포니아주')

주소 지역

addresses.locality

user.addresses.exists(address, address.locality=='남부 캘리포니아')

우편번호

addresses.postal_code

user.addresses.exists(address, address.postal_code=='94040')

사서함

addresses.po_box

user.addresses.exists(address, address.po_box=='87132')

기본 주소

addresses.primary

user.addresses.exists(address, address.primary==true)

지역

addresses.region

user.addresses.exists(address, address.region=='남서부')

상세 주소

addresses.street_address

user.addresses.exists(address, address.street_address=='Fake길 123번지')

주소 유형

addresses.type

user.addresses.exists(address, address.type==1)

이메일 주소

emails.address

user.emails.exists(email, email.address.startsWith(''))

맞춤 이메일 유형

emails.custom_type

email.address.startsWith('custom@google.com')

기본 이메일

emails.primary

user.emails.exists(email, email.primary==true)

이메일 유형

emails.type

user.emails.exists(email, email.type==1)

맞춤 외부 ID 유형

external_ids.custom_type

user.external_ids.exists(id, id.custom_type.startsWith('실행자'))

외부 ID 유형

external_ids.type

user.external_ids.exists(id, id.type==3)

외부 ID

external_ids.value

user.external_ids.exists(id, id.value=='')

성별 호칭

gender.address_me_as

user.gender.address_me_as=='그들'

맞춤 성별 유형

gender.custom_gender

user.gender.custom_gender.startsWith('맞춤 성별')

성별 유형

gender.type

user.gender.type==3

맞춤 IMS 프로토콜

ims.custom_protocol

user.ims.exists(im, im.custom_protocol.startsWith('맞춤'))

맞춤 IMS 유형

ims.custom_type

user.ims.exists(im, im.custom_type.startsWith('맞춤))im

표준 IMS 프로토콜

ims.standard_protocol

user.ims.exists(im, im.standard_protocol==7)

기본 IMS

ims.primary

user.ims.exists(im, im.primary==true)

IMS 유형

ims.type

user.ims.exists(im, im.type==3)

인스턴트 메신저

ims.value

user.ims.exists(im, im.value=='채팅')

맞춤 키워드 유형

keywords.custom_type

user.keywords.exists(keyword, keyword.custom_type.startsWith('계약업체'))

키워드 유형

keywords.type

user.keywords.exists(keyword, keyword.type==3)

키워드

keywords.value

user.keywords.exists(keyword, keyword.value=='엔지니어')

언어 코드

languages.language_code

user.languages.exists(language, language.language_code=='영어')

위치 영역

locations.area

user.locations.exists(loc, loc.area=='샌프란시스코 주변)'

건물 ID

locations.building_id

user.locations.exists(loc, loc.building_id=='')

맞춤 위치 유형

locations.custom_type

user.locations.exists(loc, loc.custom_type=='지역')

자리 코드

locations.desk_code

user.locations.exists(loc, loc.desk_code=='37번 데스크')

층 이름

locations.floor_name

user.locations.exists(loc, loc.floor_name=='')

바닥 섹션

locations.floor_section

user.locations.exists(loc, loc.floor_section=='')

위치 유형

locations.type

user.locations.exists(loc, loc.type==1)

성

name.family_name

user.name.family_name==''

이름

name.given_name

user.name.given_name==''

이름

name.value

user.name.value==''

비용 센터

organizations.cost_center

user.organizations.exists(org, org.cost_center=='')

맞춤 조직 유형

organizations.custom_type

user.organizations.exists(org, org.custom_type=='비영리단체')

부서

organizations.department

user.organizations.exists(org, org.department=='')

Employee Type(직원 유형)

organizations.description

user.organizations.exists(org, org.description=='검색 서비스 제공업체')

도메인

organizations.domain

user.organizations.exists(org, org.domain=='@example.net')

조직 위치

organizations.location

user.organizations.exists(org, org.location=='캘리포니아')

조직 이름

organizations.name

user.organizations.exists(org, org.name=='Google')

기본 조직

organizations.primary

user.organizations.exists(org, org.primary==true)

조직 기호

organizations.symbol

user.organizations.exists(org, org.symbol=='GOOG')

직책

organizations.title

user.organizations.exists(org, org.title=='')

조직 유형

organizations.type

user.organizations.exists(org, org.type==2)

맞춤 전화 분류

phones.custom_type

user.phones.exists(phone, phone.custom_type.startsWith('새 유형'))

기본 전화

phones.primary

user.phones.exists(phone, phone.primary==true)

전화 유형

phones.type

user.phones.exists(phone, phone.type==11)

전화번호

phones.value

user.phones.exists(phone, phone.value=='')

맞춤 관계 유형

relations.custom_type

user.relations.exists(rel, rel.custom_type=='예')

관계 값

relations.value

user.relations.exists(rel, rel.value=='Sundar')

관계 유형

relations.type

user.relations.exists(rel, rel.type==12)

맞춤 웹사이트 유형

websites.custom_type

user.websites.exists(site, site.custom_type.startsWith('창의적 글쓰기'))

기본 웹사이트

websites.primary

user.websites.exists(site, site.primary==true)

웹사이트 유형

websites.type

user.websites.exists(site, site.type==2)

웹사이트

websites.value

user.websites.exists(site, site.value=='google.com')

상위 조직 단위

org_units.org_unit_id

user.org_units.exists(org_unit, org_unit.org_unit_id==orgUnitId(''))

관리자 이메일

managers.user_id

user.managers.exists(manager, manager.user_id==userId(''))

보관처리됨

저장됨

user.archived==true

로그인 시 비밀번호 변경

change_password_at_next_login

user.change_password_at_next_login==true

2단계 인증 시행됨

is_2sv_enforced

user.is_2sv_enforced==true

2단계 인증 등록

is_enrolled_in_2sv

user.is_enrolled_in_2sv==true

편지함이 설정됨

is_mailbox_setup

user.is_mailbox_setup==true

기본 이메일

primary_email

user.primary_email==''

정지됨

사용중지됨

user.suspended==true

정지 이유

suspension_reason

user.suspension_reason==4

상위 조직 단위

org_unit_id

user.org_unit_id==orgUnitId('')

성별

Gender.Gender

user.custom_schemas.Gender.Gender.exists(G, G=='')

민족

Ethnicity.Ethnicity

user.custom_schemas.Ethnicity.Ethnicity.exists(E, E=='')

맞춤 속성 사용

관리 콘솔에서 멤버십 쿼리를 만들 때 조건 목록에서 표준 속성 다음에 맞춤 속성이 표시됩니다.

맞춤 속성이 포함된 쿼리를 실행하고 쿼리가 멤버 0개를 반환하는 경우 Groups API에서 속성 특성이 잘못 설정되었을 수 있습니다. 특히 'indexed' 속성을 true로 설정해야 합니다. 자세한 내용은 맞춤 사용자 속성을 참고하세요.

사용자를 자동으로 동적 그룹에 포함하기

사용자가 동적 그룹에 자동으로 포함되게 하려면 사용자의 계정 정보를 수정하여 쿼리 조건과 일치시킬 수 있습니다. Directory API를 사용하여 사용자 계정의 모든 세부정보를 수정할 수 있습니다. 자세한 내용은 사용자 계정 업데이트하기를 참고하세요.

또한 관리 콘솔(일반적으로 사용자 페이지)에서 다음과 같은 일부 사용자 계정 세부정보를 수정할 수 있습니다.

2단계 인증 시행됨 2단계 인증 등록됨
주소 유형 상위 조직 단위
건물 ID 로그인 시 비밀번호 변경
비용 센터 부서
이메일 주소 이메일 유형
외부 ID 이름
층 이름 층 섹션
보관처리됨 기본 이메일
편지함 설정됨 일시중지됨
직책 성
관리자 사용자 ID 이름
상위 조직 단위 전화번호
전화 유형

동적 그룹에서 사용자 제외하기

조건을 충족하지 않는 사용자만 추가하려면 동적 그룹에 대한 조건을 만든 다음 제외 를 클릭합니다. 예를 들어 미국에 거주하지 않는 사용자만 포함된 그룹을 만들려면 '국가 코드가 미국과 같음' 조건을 만든 다음 제외 를 클릭합니다. 쿼리에서 제외는 느낌표(!)로 표시됩니다.

'exists' 매개변수가 포함된 일부 맞춤 쿼리에서는 제외 옵션을 사용할 수 없습니다. 자세한 내용은 쿼리 공식화 및 테스트를 참고하세요.