Вы можете искать группы, соответствующие определенным атрибутам, с помощью метода groups.list
API каталога. Этот метод принимает параметр query
, который представляет собой поисковый запрос, объединяющий одно или несколько предложений поиска. Каждое предложение поиска состоит из трех частей:
- Поле
- Атрибут группы, по которому осуществляется поиск. Например,
name
. - Оператор
- Тест, выполняемый с данными для обеспечения соответствия. Например, оператор
=
проверяет, соответствует ли текстовый атрибут значению. - Ценить
- Содержимое проверяемого атрибута. Например,
groupName
.
Несколько предложений разделяются пробелами и неявно соединяются оператором AND
.
Поля
Поле | Тип значения | Операторы | Описание |
---|---|---|---|
email | нить | = , :{PREFIX}* | Адрес электронной почты группы. Примечание. Его нельзя использовать с memberKey в том же запросе. |
name | нить | = , :{PREFIX}* | Отображаемое имя группы. Примечание. Его нельзя использовать с memberKey в том же запросе. |
memberKey | нить | = , | Параметр memberKey возвращает все группы, в которых состоит пользователь или группа. Это значение может быть любым: основным или псевдонимом адреса электронной почты пользователя, основным или псевдонимом адреса электронной почты группы или уникальным идентификатором пользователя. Примечание. Его нельзя использовать вместе с параметрами email или name в одном запросе. |
Типы значений
Тип значения | Примечания |
---|---|
нить | Заключите одинарные кавычки ' если запрос содержит пробелы. Экранируйте одинарные кавычки в запросах с помощью \' , например 'Valentine\'s Day' . |
Операторы
Оператор | Поддерживаемые типы значений | Примечания |
---|---|---|
= | строка, логическое значение, число, дата | Поле и значение точно совпадают. Например, name=contact соответствует всем группам с атрибутом name "contact" , но не "contactgroup" . Поддерживается в большинстве строковых полей ( см. выше ). |
:{PREFIX}* | нить | Поле начинается со значения. Например, запрос с email:support* сопоставляет группы со значениями email "supportgroup@" и "support@" , но не "contactsupport" . Поддерживается только для ограниченного набора строковых полей ( см. выше ). |
Примеры
Все запросы используют метод groups.list
, который имеет HTTP-запрос, аналогичный следующему (для удобства чтения включены разрывы строк):
GET https://admin.googleapis.com/admin/directory/v1/groups ?domain=primary domain &query=query parameters
Параметры query
должны быть закодированы в URL. Например, запрос query=email:support*
— это URL-адрес, закодированный как query=email%3Asupport*
. Во всех примерах на этой странице показаны незакодированные параметры query
. Клиентские библиотеки автоматически обрабатывают это кодирование URL.
Поиск группы по отображаемому имени
name='contact'
Поиск групп, соответствующих префиксу электронной почты
email:admin*
Поиск всех групп пользователя
memberKey=user@company.com
Поиск групп по имени и адресу электронной почты, начинающимся с контакта.
name:contact* email:contact*