Тип ресурса group

Пространство имен: microsoft.graph

Представляет группу Azure Active Directory (Azure AD), которая может быть группой Microsoft 365 или группой безопасности. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.

Наследуется от directoryObject.

Чтобы повысить производительность, операции create, get и list возвращают только подмножество часто используемых свойств по умолчанию. Эти свойства по умолчанию указаны в разделе Свойства. Чтобы получить любые свойства, которые не возвращаются по умолчанию, укажите их в параметре запроса OData $select.

Этот ресурс поддерживает:

• добавление собственных данных к настраиваемым свойствам в виде расширений;
• подписку на уведомления об изменениях;
• отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).

Методы

Метод	Возвращаемый тип	Описание
Управление группами
Создание группы	group	Создание группы. Это может быть группа Microsoft 365, группа безопасности или динамическая группа.
Получение группы	group	Считывание свойств объекта group.
Список групп	Коллекция group	Список объектов group и их свойств.
Обновление группы	Нет	Обновление свойств объекта group.
Удаление группы	Нет	Удаление объекта group.
delta	Коллекция group	Получение добавочных изменений для групп.
Добавление участников	Нет	Добавление пользователя или группы в данную группу путем помещения в свойство навигации members (поддерживается только для групп безопасности и групп Microsoft 365).
Добавление владельцев	Нет	Добавление владельца группы путем помещения в свойство навигации owners (поддерживается только для групп безопасности и групп Microsoft 365).
Создание параметра	groupSetting	Создание параметра объекта на базе groupSettingTemplate. POST-запрос должен предоставлять объекты settingValue для всех параметров, определенных в шаблоне. В случае этой операции могут использоваться только шаблоны специально для групп.
Удаление параметра	Нет	Удаление объекта setting.
Получение параметра	groupSetting	Считывание свойств определенного объекта setting.
Перечисление groupLifecyclePolicies	Коллекция groupLifecyclePolicy	Перечисление политик жизненного цикла для групп.
Перечисление участников	Коллекция directoryObject	Получение непосредственных участников этой группы из свойства навигации members.
Перечисление владельцев	Коллекция directoryObject	Получение владельцев группы из свойства навигации owners.
Перечисление параметров	Коллекция объектов groupSetting	Перечисление свойств всех объектов setting.
Перечисление транзитивных участников	Коллекция directoryObject	Получение пользователей, групп и устройств, являющихся участниками, включая вложенных участников этой группы.
Перечисление транзитивных свойств memberOf	Коллекция directoryObject	Перечисление групп, в которых состоит эта группа. Эта операция является транзитивной и включает группы, в которых эта группа является вложенным элементом.
Удаление участника	Нет	Удаление участника из группы Microsoft 365 или группы безопасности с помощью свойства навигации members.
Удаление владельца	Нет	Удаление владельца из группы Microsoft 365 или группы безопасности с помощью свойства навигации owners.
Обновление параметра	groupSetting	Обновление объекта setting.
assignLicense	group	Добавление или удаление подписок группы. Можно также включать и отключать отдельные планы, связанные с подпиской.
renew	Boolean	Обновление, продлевающее срок действия группы. Когда группа обновляется, срок ее действия продляется на количество дней, определенное политикой.
validateProperties	JSON	Проверка соответствия отображаемого имени или почтового псевдонима группы Microsoft 365 политикам именования.
Назначение ролей приложений
Перечисление appRoleAssignments	Коллекция appRoleAssignment	Получение приложений и ролей приложений, назначенных группе.
Добавление объекта appRoleAssignment	appRoleAssignment	Назначение роли приложения группе.
Удаление объекта appRoleAssignment	Нет.	Удаление назначения роли приложения из группы.
Calendar
Создание события	event	Создание объекта event путем публикации в коллекции объектов event.
Получение события	event	Считывание свойств объекта event.
Перечисление событий	Коллекция event	Получение коллекции объектов event.
Обновление события	Нет	Обновление свойств объекта event.
Удаление события	Нет	Удаление объекта event.
Список calendarView	Коллекция event	Получение коллекции событий за указанный интервал времени.
Беседы
Создание беседы	conversation	Создание беседы путем публикации в коллекции объектов conversation.
Получение беседы	conversation	Считывание свойств объекта conversation.
Перечисление бесед	Коллекция conversation	Получение коллекции объектов conversation.
Удаление беседы	Нет	Удаление объекта conversation.
Создание цепочки	conversationThread	Создание цепочки беседы.
Получение цепочки	conversationThread	Считывание свойств объекта thread.
Перечисление цепочек	Коллекция conversationThread	Получение всех цепочек группы.
Обновление цепочки	Нет	Обновление свойств объекта thread.
Удаление цепочки	Нет	Удаление объекта thread.
Вывод acceptedSenders	Коллекция directoryObject	Получение списка пользователей или групп, включенных в список утвержденных отправителей для этой группы.
Добавление acceptedSender	directoryObject	Добавление User или Group в коллекцию acceptedSenders.
Удаление acceptedSender	directoryObject	Удаление User или Group из коллекции acceptedSenders.
Список rejectedSenders	Коллекция directoryObject	Получение списка пользователей или групп, включенных в список запрещенных отправителей для этой группы.
Добавление rejectedSender	directoryObject	Добавление User или Group в коллекцию rejectedSenders.
Удаление rejectedSender	directoryObject	Удаление нового объекта User или Group из коллекции объектов rejectedSender.
Создание параметра	groupSetting	Создание параметра объекта на базе groupSettingTemplate. POST-запрос должен предоставлять объекты settingValue для всех параметров, определенных в шаблоне. В случае этой операции могут использоваться только шаблоны специально для групп.
Объекты каталога
Перечисление удаленных групп	Коллекция directoryObject	Получение групп, удаленных в клиенте за последние 30 дней.
Перечисление удаленных групп, принадлежащих пользователю	Коллекция directoryObject	Получение групп, принадлежащих пользователю, которые удалены в клиенте за последние 30 дней.
Получение удаленной группы	Коллекция directoryObject	Получение удаленной группы по идентификатору.
Восстановление удаленной группы	Коллекция directoryObject	Восстановление группы, удаленной в клиенте за последние 30 дней.
Удаление группы без возможности восстановления	Коллекция directoryObject	Окончательное удаление группы из клиента.
checkMemberGroups	Коллекция String	Проверка участия в списке групп. Это транзитивная функция.
getMemberGroups	Коллекция String	Возврат всех групп, в которых состоит эта группа. Это транзитивная функция.
checkMemberObjects	Коллекция String	Проверка участия в списке группы, роли каталога или объектах административных единиц. Эта функция транзитивна.
getMemberObjects	Коллекция String	Возвращение всех групп и административных единиц, в которых состоит группа. Это транзитивная функция.
Параметры группы
Получение параметра	groupSetting	Считывание свойств определенного объекта setting.
Перечисление параметров	Коллекция объектов groupSetting	Перечисление свойств всех объектов setting.
Обновление параметра	Нет	Обновление объекта параметра.
Удаление параметра	Нет	Удаление объекта параметра.
Получение шаблона параметров	Нет	Чтение свойств шаблона параметров.
Перечисление шаблонов параметров	Нет	Перечисление свойств всех шаблонов параметров.
Открытые расширения
Создание открытого расширения	openTypeExtension	Создание открытого расширения и добавление настраиваемых свойств в новый или существующий ресурс.
Получение открытого расширения	Коллекция объектов openTypeExtension	Получение открытого расширения, определяемого именем расширения.
Расширения схемы
Добавление значений расширений для схемы	Нет	Создание определения расширения схемы и его дальнейшее использование для добавления в ресурс введенных пользовательских данных.
Другие ресурсы групп
Перечисление фотографий	Коллекция объектов profilePhoto	Получение коллекции фотографий профиля для группы.
Перечисление планов	Коллекция объектов plannerPlan	Получение планов, принадлежащих группе.
Параметры пользователя
addFavorite	Нет	Добавление группы в список избранных групп пользователя, выполнившего вход. Поддерживается только для групп Microsoft 365.
removeFavorite	Нет	Удаление группы из списка избранных групп пользователя, выполнившего вход. Поддерживается только для групп Microsoft 365.
Перечисление memberOf	Коллекция directoryObject	Получение групп и административных единиц, непосредственным участником которых является пользователь, из свойства навигации memberOf.
subscribeByMail	Нет	Задает значение true для свойства isSubscribedByMail. Позволяет вошедшему в систему пользователю получать беседы по электронной почте. Поддерживается только для групп Microsoft 365.
unsubscribeByMail	Нет	Задает значение false для свойства isSubscribedByMail. Отключает получение бесед по электронной почте для вошедшего в систему пользователя. Поддерживается только для групп Microsoft 365.
resetUnseenCount	Нет	Сброс до 0 значения unseenCount — счетчика всех записей, которые пользователь, выполнивший вход, не просматривал со времени последнего посещения. Поддерживается только для групп Microsoft 365.

Свойства

Важно!

Определенное использование $filter и параметра запроса $search поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual и $count. Дополнительные сведения см. в статье Расширенные возможности запросов для объектов каталога Azure AD.

Свойство	Тип	Описание
allowExternalSenders	Логическое	Указывает, могут ли пользователи за пределами организации отправлять сообщения в группу. Значение по умолчанию: false. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
assignedLabels	Коллекция assignedLabel	Список пар меток конфиденциальности (идентификатор метки, имя метки), связанных с группой Microsoft 365. Возвращается только с помощью оператора $select. Только для чтения.
assignedLicenses	Коллекция assignedLicense	Лицензии, назначенные группе. Возвращается только с помощью оператора $select. Поддерживает $filter (eq). Только для чтения.
autoSubscribeNewMembers	Boolean	Указывает, будут ли новые члены группы автоматически подписаны на получение уведомлений по электронной почте. Это свойство можно задать в запросе PATCH для группы. Не задавайте его в первоначальном запросе POST, создающем группу. Значение по умолчанию: false. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
classification	String	Описывает классификацию для группы (например, незначительное, среднее или значительное влияние на бизнес). Допустимые значения для этого свойства определяются созданием значения setting ClassificationList на базе определения шаблона. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, startsWith).
createdDateTime	DateTimeOffset	Метка времени создания группы. Значение не может изменяться и заполняется автоматически, когда создается группа. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in). Только для чтения.
deletedDateTime	DateTimeOffset	При удалении некоторых объектов Azure Active Directory (пользователя, группы, приложения) сначала происходит логическое удаление, а это свойство обновляется в соответствии с датой и временем удаления объекта. В противном случае этому свойству присваивается значение null. При восстановлении объекта значение этого свойства обновляется до null.
description	String	Необязательное описание для группы. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, startsWith) и $search.
displayName	String	Отображаемое имя для группы. Это свойство необходимо при создании группы и не может быть удалено во время обновления. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null), $search и $orderBy.
expirationDateTime	DateTimeOffset	Метка времени завершения срока действия группы. Значение не может изменяться и заполняется автоматически, когда создается группа. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in). Только для чтения.
groupTypes	Коллекция String	Задает тип группы и участие в ней. Если коллекция содержит объект Unified, эта группа является группой Microsoft 365. В противном случае она является группой безопасности или группой рассылки. Дополнительные сведения см. в обзоре групп. Если коллекция включает объект DynamicMembership, в этой группе используется динамическое участие. В противном случае участие является статическим. Возвращается по умолчанию. Поддерживает $filter (eq, not).
hasMembersWithLicenseErrors	Логический	Указывает, есть ли в этой группе участники с ошибками лицензий после группового назначения лицензий. Это свойство никогда не возвращается для операций GET. Его можно использовать в качестве аргумента $filter для получения групп, включающих участников с ошибками лицензии (то есть фильтру для этого свойства присвоено значение true). См. пример. Поддерживает $filter (eq).
hideFromAddressLists	Boolean	Значение true указывает, что группа не отображается в определенных частях пользовательского интерфейса Outlook: в адресной книге, в списках адресов для выбора получателей сообщений и в диалоговом окне Обзор групп для поиска групп. В противном случае используется значение false. Значение по умолчанию: false. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
hideFromOutlookClients	Boolean	Значение true указывает, что группа не отображается в клиентах Outlook, например Outlook для Windows и Outlook в Интернете. В противном случае используется значение false. Значение по умолчанию: false. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
id	String	Уникальный идентификатор группы. Возвращается по умолчанию. Наследуется от directoryObject. Ключ. Значение null не допускается. Только для чтения. Поддерживает $filter (eq, ne, not, in).
isArchived	Boolean	Когда группа связана с командой, это свойство определяет, находится ли команда в режиме "только для чтения".
isAssignableToRole	Логическое	Указывает, можно ли эту группу назначить роли Azure Active Directory. Необязательно. Это свойство можно настроить только при создании группы, и оно является неизменяемым. Если присвоено значение true, свойству securityEnabled также должно быть присвоено значение true, а группа не может быть динамической (то есть groupTypes не может содержать DynamicMembership). Только вызывающие с ролями глобального администратора и администратора привилегированных ролей могут настроить это свойство. Вызывающему должно быть назначено разрешение RoleManagement.ReadWrite.Directory для настройки этого свойства или обновления участников таких групп. Дополнительные сведения см. в статье Использование группы для управления назначениями ролей Azure AD Возвращается по умолчанию. Поддерживает $filter (eq, ne, not).
isSubscribedByMail	Логический	Указывает, подписан ли вошедший пользователь на получение бесед по электронной почте. Значение по умолчанию: true. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
licenseProcessingState	String	Указывает состояние назначения лицензии группы для всех участников группы. Значение по умолчанию: false. Только для чтения. Возможные значения: QueuedForProcessing, ProcessingInProgress и ProcessingComplete. Возвращается только с помощью оператора $select. Только для чтения.
почта;	String	SMTP-адрес группы, например "serviceadmins@contoso.onmicrosoft.com". Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
mailEnabled	Логический	Указывает, включена ли для этой группы поддержка почты. Обязательно. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not).
mailNickname	String	Почтовый псевдоним для группы, уникальный для групп Microsoft 365 в организации. Максимальная длина: 64 символа. Это свойство может содержать только символы из набора символов ASCII от 0 до 127, за исключением следующих: @ () \ [] " ; : . <> , SPACE. Обязательный. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
membershipRule	String	Правило, определяющее участников этой группы, если группа является динамической (groupTypes содержит DynamicMembership). Дополнительные сведения о синтаксисе правила участия см. в здесь. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, startsWith).
membershipRuleProcessingState	String	Указывает, включена или приостановлена динамическая обработка участия. Возможные значения: On и Paused. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, in).
onPremisesLastSyncDateTime	DateTimeOffset	Указывает время последней синхронизации группы с локальным каталогом. Тип Timestamp представляет сведения о времени и дате в формате ISO 8601 (время всегда указывается в формате UTC). Например, полночь 1 января 2014 г. в формате UTC представляется в виде 2014-01-01T00:00:00Z. Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	Коллекция onPremisesProvisioningError	Ошибки при использовании продукта синхронизации Майкрософт во время подготовки. Возвращается по умолчанию. Поддерживает $filter (eq, not).
onPremisesSamAccountName	String	Содержит локальное имя учетной записи SAM, синхронизированное из локального каталога. Это свойство заполняется только для клиентов, синхронизирующих свой локальный каталог с Azure Active Directory через Azure AD Connect. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith). Только для чтения.
onPremisesSecurityIdentifier	String	Содержит локальный идентификатор безопасности (SID) для локальной группы, синхронизированной с облаком. Возвращается по умолчанию. Поддерживает $filter (eq в том числе null значений). Только для чтения.
onPremisesSyncEnabled	Boolean	Значение true указывает, что эта группа синхронизируется из локального каталога. Значение false указывает, что эта группа ранее синхронизировалась из локального каталога, но синхронизация больше не выполняется. Значение null указывает, что этот объект никогда не синхронизировался из локального каталога (значение по умолчанию). Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, in и eq по null значениям).
preferredDataLocation	String	Предпочтительное расположение данных для группы Microsoft 365. По умолчанию группа наследует предпочтительное расположение данных создателя группы. Чтобы настроить это свойство, вызывающему пользователю должна быть назначена одна из указанных ниже ролей Azure AD. Глобальный администратор Администратор учетных записей пользователей Редактор каталогов Администратор Exchange Администратор SharePoint Дополнительные сведения об этом свойстве см. в статье OneDrive Online с поддержкой нескольких регионов. Допускает значение NULL. Возвращается по умолчанию.
preferredLanguage	String	Предпочтительный язык для группы Microsoft 365. Должен быть представлен в формате ISO 639-1, например en-US. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
proxyAddresses	Коллекция String	Адреса электронной почты для группы, ведущие в один почтовый ящик группы. Пример: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Для фильтрации выражений по многозначным свойствам требуется оператор any. Возвращается по умолчанию. Только для чтения. Значение null не допускается. Поддерживает $filter (eq, not, ge, le, startsWith, endsWith и подсчет пустых коллекций).
renewedDateTime	DateTimeOffset	Метка времени последнего обновления группы. Не может изменяться непосредственно. Обновляется только при выполнении действия обновления. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in). Только для чтения.
resourceBehaviorOptions	Коллекция объектов string	Определяет поведение группы, которое может быть задано для группы Microsoft 365 во время ее создания. Это можно сделать только в рамках операции создания (POST). Возможные значения: AllowOnlyMembersToPost, HideGroupInOutlook, SubscribeNewGroupMembers, WelcomeEmailDisabled. Дополнительные сведения см. в статье Настройка вариантов поведения и подготовки групп Microsoft 365.
resourceProvisioningOptions	Коллекция объектов string	Определяет ресурсы группы, которые были подготовлены в рамках создания групп Microsoft 365 и обычно не являются частью процесса создания группы по умолчанию. Возможное значение: Team. Дополнительные сведения см. в статье Настройка вариантов поведения и подготовки групп Microsoft 365.
securityEnabled	Boolean	Указывает, является ли эта группа группой безопасности. Обязательно. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, in).
securityIdentifier	String	Идентификатор безопасности группы, используемый в сценариях Windows. Возвращается по умолчанию.
theme	String	Указывает цветовую тему группы Microsoft 365. Возможные значения: Teal, Purple, Green, Blue, Pink, Orange или Red. Возвращается по умолчанию.
unseenCount	Int32	Количество бесед с новыми сообщениями, полученными с момента последнего посещения группы вошедшим в систему пользователем. Возвращается только в $select. Поддерживается только для API получения группы (GET /groups/{ID}).
visibility	String	Указывает политику присоединения к группе и видимость содержимого для групп. Возможные значения: Private, Public или Hiddenmembership. Hiddenmembership задается только для Групп Microsoft 365 при их создании. Обновление невозможно выполнить позже. Другие значения видимости можно обновлять после создания группы. Если при создании группы в Microsoft Graph не задается значение видимости, группа безопасности по умолчанию создается как Private, а группа Microsoft 365 —Public. Группы, которые можно назначить ролям, всегда являются Private. Дополнительные сведения см. в разделе Параметры видимости группы. Возвращается по умолчанию. Допускает значение NULL.

Параметры видимости группы

Значение	Описание
Public	К группе может присоединиться любой пользователь без необходимости разрешения владельца. Любой пользователь может просматривать атрибуты группы. Любой пользователь может просматривать участников группы.
Private	Чтобы присоединиться к группе, требуется разрешение владельца. Пользователи, не являющиеся участниками группы, не могут просматривать ее атрибуты. Любой пользователь может просматривать участников группы.
Hiddenmembership	Чтобы присоединиться к группе, требуется разрешение владельца. Пользователи, не являющиеся участниками группы, не могут просматривать ее атрибуты. Пользователи, не являющиеся участниками группы, не могут просматривать ее участников. Администраторы (глобальные, организации, пользователей и службы поддержки) могут просматривать список участников группы. Группа отображается в глобальной адресной книге (глобальном списке адресов).

Связи

Связь	Тип	Описание
acceptedSenders	Коллекция directoryObject	Список пользователей или групп, которым разрешено создавать записи или события календаря в этой группе. Если этот список не пуст, то добавлять записи разрешено только перечисленным в нем пользователям и группам.
appRoleAssignments	Коллекция appRoleAssignment	Представляет роли группе, предоставленные пользователю для приложения. Поддерживает $expand.
calendar	calendar	Календарь группы. Только для чтения.
calendarView	Коллекция event	Представление календаря. Только для чтения.
conversations	Коллекция conversation	Беседы группы.
createdOnBehalfOf	directoryObject	Пользователь или приложение, создавшие группу. ПРИМЕЧАНИЕ. Это значение не задается, если пользователь является администратором. Только для чтения.
drive	drive	Используемый по умолчанию диск группы. Только для чтения.
drives	Коллекция drive	Диски группы. Только для чтения.
events	Коллекция event	События в календаре группы.
extensions	Коллекция extension	Коллекция открытых расширений, определенных для группы. Только для чтения. Допускается значение null.
groupLifecyclePolicies	Коллекция groupLifecyclePolicy	Коллекция политик жизненного цикла для этой группы. Только для чтения. Допускается значение NULL.
memberOf	Коллекция directoryObject	Группы, в которых состоит эта группа. Методы HTTP: GET (поддерживается для всех групп). Только для чтения. Допускается значение NULL. Поддерживает $expand.
members	Коллекция directoryObject	Участники этой группы, которые могут быть пользователями, устройствами, другими группами или субъектами-службы. Поддерживает операции Перечисление участников, Добавление участника и Удаление участника. Допускается значение null. Поддерживает $expand, включая вложенные $select. Например, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).
membersWithLicenseErrors	Коллекция User	Список участников группы с ошибками лицензий в этом групповом назначении лицензий. Только для чтения.
onenote	Onenote	Только для чтения.
owners	Коллекция directoryObject	Владельцы группы. Максимальное количество владельцев: 100. Допускается значение NULL. Если это свойство не указано при создании группы Microsoft 365, вызывающий пользователь автоматически назначается владельцем группы. Поддерживает $expand, включая вложенные $select. Например, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants	resourceSpecificPermissionGrant	Разрешение, предоставленное группе для определенного приложения. Поддерживает $expand.
photo;	profilePhoto	Фотография профиля группы.
photos	Коллекция объектов profilePhoto	Фотографии профиля, принадлежащие группе. Только для чтения. Допускается значение null.
planner	plannerGroup	Точка входа в ресурс Planner, который может существовать для единой группы.
rejectedSenders	Коллекция directoryObject	Список пользователей или групп, которым запрещено создавать записи или события календаря в этой группе. Допускается значение null.
settings	Коллекция объектов groupSetting	Параметры, управляющие поведением группы, например, могут ли участники приглашать гостевых пользователей в группу. Допускается значение NULL.
sites	Коллекция объектов site	Список сайтов SharePoint в этой группе. Для доступа к сайту по умолчанию используйте путь /sites/root.
team	Коллекция channel	Команда, связанная с этой группой.
threads	Коллекция conversationThread	Цепочки бесед группы. Допускается значение null.

Представление JSON

Ниже указано представление ресурса в формате JSON.

{
  "allowExternalSenders": false,
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "autoSubscribeNewMembers": true,
  "classification": "String",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "groupTypes": ["String"],
  "hasMembersWithLicenseErrors": "Boolean",
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isSubscribedByMail": true,
  "isAssignableRole": false,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenCount": 1024,
  "visibility": "String",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }]
}

См. также

• Добавление пользовательских данных в ресурсы с помощью расширений
• Добавление пользовательских данных в ресурсы user с помощью открытых расширений
• Добавление пользовательских данных в группы с помощью расширений схемы