Для создания запросов на членство в динамических группах в консоли администратора Google можно использовать стандартные атрибуты по умолчанию, созданные вами пользовательские атрибуты или и то, и другое.
На этой странице
- Используйте стандартные атрибуты
- Используйте пользовательские атрибуты
- Автоматическое включение пользователя в динамическую группу
- Исключить пользователей из динамической группы
Используйте стандартные атрибуты
При создании динамической группы в консоли администратора вы выбираете стандартные атрибуты из списка «Условия». Вы можете использовать все атрибуты из приведенной ниже таблицы для создания запросов на членство для динамических групп.
Атрибут | Пример кода |
|---|---|
Страна адреса.страна | user.addresses.exists(address, address.country == 'Canada') |
Код страны 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=='California, USA') |
Адрес населенного пункта адреса.локальность | user.addresses.exists(address, address.locality=='Southern California') |
Почтовый индекс адреса.почтовый_код | user.addresses.exists(address, address.postal_code=='94040') |
А/я addresses.po_box | user.addresses.exists(address, address.po_box=='87132') |
Является ли адрес основным? адреса.первичные | user.addresses.exists(address, address.primary==true) |
Область адреса.регион | user.addresses.exists(address, address.region=='Southwest') |
адрес улицы addresses.street_address | user.addresses.exists(address, address.stree_address=='123 Fake St') |
Тип адреса адреса.тип | 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) |
Пользовательский внешний тип идентификатора external_ids.custom_type | user.external_ids.exists(id, id.custom_type.startsWith('runner')) |
Внешний тип идентификатора external_ids.type | user.external_ids.exists(id, id.type==3) |
Внешний идентификатор external_ids.value | user.external_ids.exists(id, id.value=='') |
Гендерные местоимения gender.address_me_as | user.gender.address_me_as=='they/them' |
Пользовательский тип пола gender.custom_gender | user.gender.custom_gender.startsWith('custom gender') |
Тип пола гендер.тип | 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') |
Пользовательский тип ключевого слова ключевые слова.пользовательский_тип | user.keywords.exists(keyword, keyword.custom_type.startsWith('contractor')) |
Тип ключевых слов ключевые слова.тип | user.keywords.exists(keyword, keyword.type==3) |
Ключевое слово ключевые слова.значение | user.keywords.exists(keyword, keyword.value=='engineer') |
Языковой код languages.language_code | user.languages.exists(language, language.language_code=='English') |
Местоположение местоположения.район | user.locations.exists(loc, loc.area=='Near San Francisco') |
Идентификатор здания 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) |
Фамилия имя.фамилия | user.name.family_name=='' |
Имя имя.имя | user.name.given_name=='' |
Имя имя.значение | user.name.value=='' |
Центр затрат организации.центр_затрат | user.organizations.exists(org, org.cost_center=='') |
Тип организации по умолчанию организации.custom_type | user.organizations.exists(org, org.custom_type=='nonprofit') |
Отделение организации.отдел | user.organizations.exists(org, org.department=='') |
Тип сотрудника организации.описание | user.organizations.exists(org, org.description=='search provider') |
Домен организации.домен | user.organizations.exists(org, org.domain=='example.net') |
местоположение организации организации.местоположение | user.organizations.exists(org, org.location=='California') |
Название организации организации.название | user.organizations.exists(org, org.name=='Google') |
Является ли организация первостепенной задачей? организации.первичные | user.organizations.exists(org, org.primary==true) |
Символ организации организации.символ | user.organizations.exists(org, org.symbol=='GOOG') |
Должность организации.титул | user.organizations.exists(org, org.title=='') |
Тип организации организации.тип | user.organizations.exists(org, org.type==2) |
Пользовательский тип телефона телефоны.пользовательский_тип | user.phones.exists(phone, phone.custom_type.startsWith('new type')) |
Является ли телефон основным телефоны.основной | user.phones.exists(phone, phone.primary==true) |
Тип телефона телефоны.тип | user.phones.exists(phone, phone.type==11) |
Номер телефона phones.value | user.phones.exists(phone, phone.value=='') |
Пользовательский тип связи отношения.custom_type | user.relations.exists(rel, rel.custom_type=='example') |
Отношение к ценности отношения.значение | user.relations.exists(rel, rel.value=='Sundar') |
Тип отношения отношения.тип | user.relations.exists(rel, rel.type==12) |
Пользовательский тип веб-сайта websites.custom_type | user.websites.exists(site, site.custom_type.startsWith('creative writing')) |
Является ли веб-сайт основным веб-сайты.основные | user.websites.exists(site, site.primary==true) |
Тип веб-сайта веб-сайты.тип | 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('')) |
Электронная почта менеджера менеджеры.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 |
Внедрена двухэтапная проверка. is_2sv_enforced | user.is_2sv_enforced==true |
Зарегистрирована двухэтапная проверка. is_enrolled_in_2sv | user.is_enrolled_in_2sv==true |
Почтовый ящик настроен is_mailbox_setup | user.is_mailbox_setup==true |
Основной адрес электронной почты основной_электронный_почта | user.primary_email=='' |
Отстранен приостановленный | user.suspended==true |
Причина отстранения причина_приостановки | user.suspension_reason==4 |
Родительское организационное подразделение org_unit_id | user.org_unit_id==orgUnitId('') |
Пол Гендер.Гендер | user.custom_schemas.Gender.Gender.exists(G, G=='') |
Этническая принадлежность Этническая принадлежность. Этническая принадлежность | user.custom_schemas.Ethnicity.Ethnicity.exists(E, E=='') |
Используйте пользовательские атрибуты
При создании запроса на определение членства в консоли администратора пользовательские атрибуты отображаются после стандартных атрибутов в списке условий.
Если при выполнении запроса, содержащего пользовательский атрибут, возвращается ноль участников, возможно, свойства атрибута заданы некорректно в API групп. В частности, свойство "indexed" необходимо установить в значение true. Подробнее см. в разделе "Пользовательские атрибуты ".
Автоматическое включение пользователя в динамическую группу
Вы можете редактировать информацию об учетной записи пользователя, чтобы она соответствовала условиям запроса для автоматического включения пользователя в динамическую группу. Редактировать любые данные учетной записи пользователя можно с помощью API каталога. Для получения подробной информации перейдите в раздел «Обновление учетной записи пользователя» .
Также вы можете редактировать некоторые данные учетных записей пользователей в консоли администратора, как правило, на странице «Пользователи», в том числе:
| Внедрена двухэтапная проверка. | Зарегистрирована двухэтапная проверка. |
| Тип адреса | Организационная единица предков |
| Идентификатор здания | Изменить пароль при входе в систему. |
| Центр затрат | Отделение |
| Адрес электронной почты | Тип электронной почты |
| Внешний идентификатор | Имя |
| Название этажа | Секция этажа |
| Архив | Является ли электронная почта основным способом связи |
| Почтовый ящик настроен | Отстранен |
| Должность | Фамилия |
| Идентификатор пользователя менеджера | Имя |
| Родительское организационное подразделение | Номер телефона |
| Тип телефона |
Исключить пользователей из динамической группы
Чтобы добавить только тех пользователей, которые не соответствуют условию, создайте условие для динамической группы, а затем нажмите кнопку «Исключить». 
Например, чтобы создать группу, содержащую только пользователей, не проживающих в США, необходимо задать условие «Код страны равен США», а затем нажать кнопку «Исключить». В запросе вы получаете восклицательный знак (!) для обозначения исключения.
Для некоторых пользовательских запросов с параметром "exists" нельзя использовать опцию исключения. Подробнее см. в разделе "Составление и тестирование запроса" .