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=='Southern California') |
|
우편번호 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=='Southwest') |
|
상세 주소 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('custom')) |
|
맞춤 IMS 유형 ims.custom_type |
user.ims.exists(im, im.custom_type.startsWith('custom')) |
|
표준 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=='chat') |
|
맞춤 키워드 유형 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=='engineer') |
|
언어 코드 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=='Region') |
|
자리 코드 locations.desk_code |
user.locations.exists(loc, loc.desk_code=='Desk 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=='example') |
|
관계 값 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('creative writing')) |
|
기본 웹사이트 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 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' 매개변수가 포함된 일부 맞춤 쿼리에서는 제외 옵션을 사용할 수 없습니다. 자세한 내용은 쿼리 공식화 및 테스트를 참고하세요.