Запросы для включения в динамические группы можно создавать в консоли администратора Google, используя при этом как стандартные, так и настраиваемые атрибуты.
Содержание
- Стандартные атрибуты
- Настраиваемые атрибуты
- Как добавить пользователя в динамическую группу автоматически
- Как исключить пользователей из динамической группы
Стандартные атрибуты
Создавая динамическую группу в консоли администратора, вы можете выбрать стандартные атрибуты в списке "Условия". В таблице ниже перечислены атрибуты, которые можно использовать для создания запросов для включения в динамические группы.
|
Атрибут |
Образец кода |
|---|---|
|
Country (Страна) 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=='Ул. Абрикосовая, 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) |
|
Собственный тип внешнего идентификатора external_ids.custom_type |
user.external_ids.exists(id, id.custom_type.startsWith('снабжение')) |
|
Тип внешнего идентификатора 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=='они/им' |
|
Собственный пол gender.custom_gender |
user.gender.custom_gender.startsWith('другой пол') |
|
Пол gender.type |
user.gender.type==3 |
|
Собственный протокол обмена мгновенными сообщениями ims.custom_protocol |
user.ims.exists(im, im.custom_protocol.startsWith('название протокола')) |
|
Собственный тип аккаунта в службе обмена мгновенными сообщениями ims.custom_type |
user.ims.exists(im, im.custom_type.startsWith('название типа')) |
|
Стандартный протокол обмена мгновенными сообщениями ims.standard_protocol |
user.ims.exists(im, im.standard_protocol==7) |
|
Это основная служба обмена мгновенными сообщениями ims.primary |
user.ims.exists(im, im.primary==true) |
|
Тип аккаунта в службе обмена мгновенными сообщениями 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=='Под Санкт-Петербургом') |
|
Идентификатор здания 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) |
|
Last name (Фамилия) name.family_name |
user.name.family_name=='' |
|
First name (Имя) name.given_name |
user.name.given_name=='' |
|
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=='') |
|
Тип сотрудника 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=='Василий') |
|
Тип отношения 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('')) |
|
В архиве archived |
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 |
|
Основной адрес электронной почты primary_email |
user.primary_email=='' |
|
Аккаунт заблокирован suspended |
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=='') |
Настраиваемые атрибуты
Когда вы создаете запрос для включения в группу в консоли администратора, настраиваемые атрибуты отображаются после стандартных атрибутов в списке "Условия".
Если выполняемый вами запрос, который содержит настраиваемый атрибут, не вернул ни одного результата, возможно, вы неправильно задали свойства атрибута в Groups API. В частности, свойство "indexed" должно иметь значение true. Подробнее о настраиваемых атрибутах пользователей…
Как добавить пользователя в динамическую группу автоматически
Вы можете изменить сведения об аккаунте пользователя так, чтобы они соответствовали условиям запроса, и пользователь добавлялся в динамическую группу автоматически. Эти сведения можно изменить с помощью Directory API. Подробнее о том, как это сделать…
Некоторые сведения можно изменить в консоли администратора на странице "Пользователи". К ним относятся, в том числе, атрибуты из таблицы ниже.
| Принудительная двухэтапная аутентификация | Двухэтапная аутентификация включена |
| Тип адреса | Родительское организационное подразделение |
| Идентификатор здания | Смена пароля при входе |
| Центр затрат | Отдел |
| Адрес электронной почты | Тип электронной почты |
| Внешний идентификатор | Имя |
| Название этажа | Секция этажа |
| В архиве | Это основной адрес электронной почты |
| Почтовый ящик настроен | Аккаунт заблокирован |
| Должность | Фамилия |
| Идентификатор менеджера | Название |
| Идентификатор организационного подразделения | Номер телефона |
| Тип номера телефона |
Как исключить пользователей из динамической группы
Чтобы добавить в динамическую группу только тех пользователей, которые не соответствуют условию, создайте его, а затем нажмите "Исключить" 
. Например, чтобы создать группу, в которой будут только те пользователи, которые не проживают в США, создайте условие "Код страны равняется US", а затем нажмите "Исключить" . В запросе исключение обозначается восклицательным знаком (!).
В некоторых специальных запросах с параметром "exists" исключение использовать нельзя. Подробнее о том, как составлять и проверять запросы…