Тип ресурса group

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

Представляет группу Microsoft Entra, группу Microsoft 365 или группу безопасности. Этот ресурс имеет открытый тип, который допускает дополнительные свойства, помимо описанных здесь.

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

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

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

Методы

Метод Возвращаемый тип Описание
Список Коллекция group Список объектов group и их свойств.
Создание group Создание группы. Это может быть группа Microsoft 365, группа безопасности или динамическая группа.
Получение group Считывание свойств объекта group.
Обновление Нет Обновление свойств объекта group.
Upsert group Создайте новую группу, если ее нет, или обновите свойства существующей группы.
Delete Нет Удаление объекта group.
Получение дельты Коллекция group Получение добавочных изменений для групп.
Управление группами
Перечисление участников Коллекция directoryObject Получение непосредственных участников этой группы из свойства навигации members.
Добавление участников Нет Добавьте участника в эту группу, выполнив запись в свойстве навигации для участников (поддерживается только для групп безопасности и групп Microsoft 365).
Удаление участника Нет Удаление участника из группы Microsoft 365 или группы безопасности с помощью свойства навигации members.
Список владельцев Коллекция directoryObject Получение владельцев группы из свойства навигации owners.
Добавление владельцев Нет Добавление владельца группы путем помещения в свойство навигации owners (поддерживается только для групп безопасности и групп Microsoft 365).
Удаление владельца Нет Удаление владельца из группы Microsoft 365 или группы безопасности с помощью свойства навигации owners.
Список статусов Коллекция directoryObject Получите группы, роли администраторов и административные единицы, прямым участником которых является эта группа, из свойства навигации memberOf.
Перечисление транзитивных участников Коллекция directoryObject Получить пользователей, группы и устройства, которые являются участниками, включая вложенные члены этой группы.
Вывод списка транзитивных членств Коллекция directoryObject Перечисление групп, в которых состоит эта группа. Эта операция является транзитивной и включает группы, в которых эта группа является вложенным элементом.
Вывод списка политик жизненного цикла группы Коллекция groupLifecyclePolicy Перечисление политик жизненного цикла для групп.
Назначение лицензии group Добавление или удаление подписок группы. Вы также можете включать и отключать отдельные планы, связанные с подпиской.
Renew Логический Обновляет срок действия группы. Продление продлевает срок действия группы на количество дней, определенное в политике.
Проверка свойств JSON Проверка соответствия отображаемого имени или почтового псевдонима группы Microsoft 365 политикам именования.
Назначение ролей приложений
List Коллекция appRoleAssignment Получите приложения и роли приложений, назначенные этой группе.
Добавление appRoleAssignment Назначение роли приложения группе.
Remove Нет. Удаление назначения роли приложения из группы.
Calendar
Получение календаря calendar Получение календаря группы.
Обновление календаря Нет Обновите календарь группы.
Получение списка событий Коллекция event Получение коллекции объектов event.
Создание события event Создание объекта event путем публикации в коллекции объектов event.
Получение события event Считывание свойств объекта event.
Обновление события Нет Обновление свойств объекта event.
Удаление события Нет Удаление объекта event.
Список представлений календаря Коллекция event Получение коллекции событий за указанный интервал времени.
Беседы
Перечисление бесед Коллекция conversation Получение коллекции объектов conversation.
Создание беседы conversation Создание беседы путем публикации в коллекции объектов conversation.
Получение беседы conversation Считывание свойств объекта conversation.
Удаление беседы Нет Удаление объекта conversation.
Перечисление цепочек Коллекция conversationThread Получение всех цепочек группы.
Создание цепочки conversationThread Создание цепочки беседы.
Получение цепочки conversationThread Считывание свойств объекта thread.
Обновление цепочки Нет Обновление свойств объекта thread.
Удаление цепочки Нет Удаление объекта thread.
Вывод списка разрешенных отправителей Коллекция directoryObject Получение списка пользователей или групп, включенных в список утвержденных отправителей для этой группы.
Добавить принятого отправителя directoryObject Добавление User или Group в коллекцию acceptedSenders.
Удаление разрешенного отправителя directoryObject Удаление User или Group из коллекции acceptedSenders.
Список отклоненных отправителей Коллекция directoryObject Получение списка пользователей или групп, включенных в список запрещенных отправителей для этой группы.
Добавление отклоненного отправителя directoryObject Добавление User или Group в коллекцию rejectedSenders.
Удаление отклоненного отправителя directoryObject Удаление нового объекта User или Group из коллекции объектов rejectedSender.
Объекты каталога
Перечисление удаленных элементов Коллекция directoryObject Получение групп, удаленных в клиенте за последние 30 дней.
Получение удаленного элемента Коллекция directoryObject Получение удаленной группы по идентификатору.
Восстановление удаленного элемента Коллекция directoryObject Восстановление группы, удаленной в клиенте за последние 30 дней.
Удаление элемента без возможности восстановления Коллекция directoryObject Окончательное удаление группы из клиента.
Перечисление удаленных элементов, принадлежащих пользователю Коллекция directoryObject Получите доступ к группам пользователей, удаленным в клиенте за последние 30 дней.
Проверка членства в группах Коллекция строк Проверка членства в списке групп. Это транзитивная функция.
Получение групп пользователя Коллекция строк Возврат всех групп, в которых состоит эта группа. Это транзитивная функция.
Проверка объектов-элементов Коллекция String Проверка участия в списке группы, роли каталога или объектах административных единиц. Это транзитивная функция.
Вывод объектов членства Коллекция строк Верните все группы и административные единицы, участником которых является группа. Это транзитивная функция.
Drive
Получение объекта drive drive Получение свойств и связей ресурса Drive.
Список дочерних элементов DriveItems Возвращает коллекцию DriveItems в дочерних элементах ресурса DriveItem.
Параметры группы
List Коллекция объектов groupSetting Перечисление свойств всех объектов setting.
Создание groupSetting Создайте объект настройки на основе groupSettingTemplate. Запрос POST должен предоставить значения settingValues для всех параметров, определенных в шаблоне. Для этой операции можно использовать только шаблоны, относящиеся к группам.
Получение groupSetting Считывание свойств определенного объекта setting.
Обновление Нет Обновление объекта параметра.
Delete Нет Удаление объекта setting.
Перечисление шаблонов параметров Нет Перечисление свойств всех шаблонов параметров.
Получение шаблона параметров Нет Чтение свойств шаблона параметров.
Примечания.
Список записных книжек Коллекция объектов notebook Получение списка объектов notebook.
Создание записной книжки notebook Создание записной книжки OneNote.
Фотография профиля
Получение profilePhoto Получение указанного объекта profilePhoto или его метаданных (свойств profilePhoto).
Обновление Нет Обновление фотографии любого пользователя в клиенте, в том числе пользователя, выполнившего вход, либо указанной группы или контакта.
Delete Нет Удалите фотографию любого пользователя в клиенте, включая вошедшего пользователя или указанную группу.
Планировщик
Список планов Коллекция объектов plannerPlan Получите планы, назначенные группе.
Posts
List Коллекция post Получение публикаций в цепочке беседы.
Получение post Получить конкретную запись.
Ответить на запись Нет Ответ на запись.
Пересылка записи Нет Пересылка публикации.
Другие ресурсы групп
Перечисление предоставленных разрешений Коллекция resourceSpecificPermissionGrant Перечислите разрешения, предоставленные приложениям для доступа к группе.
Параметры пользователя
Добавление в избранное Нет Добавление группы в список избранных групп вошедшего пользователя. Поддерживается только для групп Microsoft 365.
Удаление из избранного Нет Удаление группы из списка избранных групп вошедшего пользователя. Поддерживается только для групп Microsoft 365.
Список свойств member of Коллекция directoryObject Получение групп и административных единиц, непосредственным участником которых является пользователь, из свойства навигации memberOf.
Список групп, к которым присоединился пользователь Коллекция group Получение команд Microsoft Teams, непосредственным участником которых является пользователь.
Перечисление связанных команд коллекция associatedTeamInfo Получите список объектов associatedTeamInfo в Microsoft Teams, с которыми связан пользователь.
Подписка по почте Нет Задает для свойства isSubscribedByMail значение true. Позволяет вошедшему пользователю получать беседы по электронной почте. Поддерживается только для групп Microsoft 365.
Отмена подписки по почте Нет Задает для свойства isSubscribedByMail значение false. Отключает получение бесед по электронной почте для вошедшего пользователя. Поддерживается только для групп Microsoft 365.
Сброс количества непросмотренных элементов Нет Сбросьте значение unseenCount до 0 всех записей, которые вошедший в систему пользователь не видел с момента своего последнего посещения. Поддерживается только для групп Microsoft 365.

Свойства

Важно!

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

Свойство Тип Описание
accessType groupAccessType Указывает тип доступа к группе. Допустимые значения: none, private, secret, public, unknownFutureValue. Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
allowExternalSenders Логический Указывает, могут ли пользователи за пределами организации отправлять сообщения в группу. Значение по умолчанию — false.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
assignedLabels Коллекция assignedLabel Список пар меток конфиденциальности (идентификатор метки, имя метки), связанных с группой Microsoft 365 или облачной группой безопасности. Требуется лицензия Microsoft Entra ID P1.

Требуется $select получение. Это свойство можно указать при создании или обновлении группы. Однако для облачных групп безопасности он является неизменным после настройки. Это свойство можно обновлять только в делегированных сценариях, когда вызывающему объекту требуется разрешение Microsoft Graph и поддерживаемая роль администратора. См. статью "Ключевые отличия от меток групп Microsoft 365 ", чтобы узнать больше об управлении этим свойством для Microsoft 365 и облачных групп безопасности.
assignedLicenses Коллекция assignedLicense Лицензии, назначенные группе.

Требуется $select получение. Поддерживает $filter (eq). Только для чтения.
autoSubscribeNewMembers Логический Указывает, подписаны ли новые участники, добавленные в группу, автоматически на получение уведомлений по электронной почте. Вы можете установить это свойство в запросе PATCH для группы; не устанавливайте его в первоначальном запросе POST, который создает группу. Значение по умолчанию — false.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
classification String Описывает классификацию для группы (например, низкое, среднее или высокое влияние на бизнес). Допустимые значения этого свойства определяются путем создания значения параметра ClassificationList на основе определения шаблона.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, startsWith).
createdDateTime DateTimeOffset Метка времени создания группы. Значение нельзя изменить, оно заполняется автоматически при создании группы. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь по UTC 1 января 2014 года — это 2014-01-01T00:00:00Z.

Возвращается по умолчанию. Только для чтения.
deletedDateTime DateTimeOffset Для некоторых объектов Microsoft Entra (пользователь, группа, приложение) при удалении объекта сначала логически удаляется, а это свойство обновляется с указанием даты и времени удаления объекта. В противном случае это свойство имеет значение null. При восстановлении объекта это свойство обновляется до null. Наследуется от directoryObject.
description String Необязательное описание для группы.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, startsWith) и $search.
displayName String Отображаемое имя для группы. Это свойство необходимо при создании группы и не может быть очищено во время обновления. Максимальная длина: 256 символов.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null), $search и $orderby.
expirationDateTime DateTimeOffset Метка времени завершения срока действия группы. Он предназначен null для групп безопасности, но для групп Microsoft 365 он указывает, когда для группы истекает срок действия, как определено в groupLifecyclePolicy. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда в формате UTC. Например, полночь по UTC 1 января 2014 года — это 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 Логический True, если группа не отображается в определенных частях пользовательского интерфейса Outlook: в адресной книге, списках адресов для выбора получателей сообщения и в диалоговом окне "Обзор групп " для поиска групп; в противном случае — значение "false". Значение по умолчанию — false.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
hideFromOutlookClients Логический Значение True, если группа не отображается в клиентах Outlook, таких как Outlook для Windows и Outlook в Интернете; в противном случае — значение false. Значение по умолчанию — false.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
id String Уникальный идентификатор группы.

Возвращается по умолчанию. Наследуется от directoryObject. Ключ. Значение null не допускается. Только для чтения.

Поддерживает $filter (eq, ne, not, in).
isArchived Boolean Когда группа связана с командой, это свойство определяет, находится ли команда в режиме "только для чтения".
Чтобы прочитать это свойство, используйте конечную точку /group/{groupId}/team или API получения сведений о команде. Чтобы обновить это свойство, используйте API archiveTeam и unarchiveTeam.
isAssignableToRole Логическое Указывает, можно ли назначить этой группе роль Microsoft Entra. Необязательный параметр.

Это свойство можно настроить только при создании группы, и оно является неизменяемым. Если задано значение true, для свойства securityEnabled также должно быть установлено значение true, visibility должно быть равно Hidden, и группа не может быть динамической группой (то есть groupTypes не может содержать DynamicMembership).

Это свойство могут задать только вызывающие объекты хотя бы с ролью администратора привилегированной роли. Вызывающему объекту также должно быть назначено разрешение RoleManagement.ReadWrite.Directory для настройки этого свойства или обновления членства в таких группах. Дополнительные сведения см. в разделе Использование группы для управления назначениями ролей Microsoft Entra

Для использования этой функции требуется лицензия Microsoft Entra ID P1. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not).
isFavorite Boolean Указывает, отметил ли пользователь группу как избранную. Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
isManagementRestricted Логический Указывает, является ли группа членом административной единицы управления с ограниченным управлением. Если не установлено, значением по умолчанию является null "false". Только для чтения.

Чтобы управлять членом группы административной единицы ограниченного управления, администратору или вызывающему приложению должна быть назначена роль Microsoft Entra в области административной единицы ограниченного управления.

Требуется $select получение.
isSubscribedByMail Логический Указывает, подписан ли вошедший пользователь на получение бесед по электронной почте. Значение по умолчанию — true.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
licenseProcessingState String Указывает состояние назначения лицензии группе всем участникам группы. Значение по умолчанию — false. Только для чтения. Возможные значения: QueuedForProcessing, ProcessingInProgress и ProcessingComplete.

Требуется $select получение. Только для чтения.
mail String SMTP-адрес группы, например "serviceadmins@contoso.com".

Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
mailEnabled Boolean Указывает, включена ли для этой группы поддержка почты. Обязательный.

Возвращается по умолчанию. Поддерживает $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).
onPremisesDomainName String Содержит локальный параметр domain FQDN, также называемый dnsDomainName, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих свой локальный каталог с Microsoft Entra ID через Microsoft Entra Connect.

Возвращается по умолчанию. Только для чтения.
onPremisesExtensionAttributes onPremisesExtensionAttributes Сложный тип, содержащий атрибуты расширения 1–15 для группы, синхронизируемые из локальной службы Active Directory. Возвращается только с помощью оператора $select. Поддерживает $filter (eq, ne, not, in).
onPremisesLastSyncDateTime DateTimeOffset Указывает на время, когда группа последний раз синхронизировалась с локальным каталогом. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь по UTC 1 января 2014 года — это 2014-01-01T00:00:00Z.

Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesNetBiosName String Содержит локальный параметр netBios name, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих свой локальный каталог с Microsoft Entra ID через Microsoft Entra Connect.

Возвращается по умолчанию. Только для чтения.
onPremisesProvisioningErrors Коллекция onPremisesProvisioningError Ошибки при использовании продукта синхронизации Майкрософт во время подготовки.

Возвращается по умолчанию. Поддерживает $filter (eq, not).
onPremisesSamAccountName String Содержит локальный параметр SAM account name, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих свой локальный каталог с Microsoft Entra ID через Microsoft Entra Connect.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith). Только для чтения.
onPremisesSecurityIdentifier String Содержит локальный идентификатор безопасности (SID) группы, синхронизированной из локальной среды в облако. Только для чтения.

Возвращается по умолчанию. Поддерживает $filter (eq в том числе null значений).
onPremisesSyncEnabled Логический true если эта группа синхронизируется из локального каталога; false если эта группа была изначально синхронизирована из локального каталога, но больше не синхронизируется; NULL , если этот объект никогда не синхронизировался из локального каталога (по умолчанию).

Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq, ne, not, in и eq для значений null).
preferredDataLocation String Предпочтительное расположение данных для группы Microsoft 365. По умолчанию группа наследует предпочтительное расположение данных создателя группы. Чтобы задать это свойство, вызывающему приложению необходимо предоставить разрешение Directory.ReadWrite.All и назначить пользователю по крайней мере одну из следующих ролей Microsoft Entra:
    Администратор учетных записей пользователей
  • Редактор каталогов
  • Администратор 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, /$count eq 0, /$count ne 0).
renewedDateTime DateTimeOffset Метка времени последнего обновления группы. Это значение нельзя изменить напрямую, оно обновляется только с помощью действия службы продления. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда в формате UTC. Например, полночь по UTC 1 января 2014 года — это 2014-01-01T00:00:00Z.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, ge, le, in). Только для чтения.
resourceBehaviorOptions Коллекция объектов string Определяет поведение группы, которое может быть задано для группы Microsoft 365 во время ее создания. Это свойство можно задать только в процессе создания (POST). Список возможных значений см. в статье "Поведение группы Microsoft 365 и параметры подготовки".
resourceProvisioningOptions Коллекция объектов string Указывает ресурсы группы, связанные с группой Microsoft 365. Возможное значение: Team. Дополнительные сведения см. в статье Поведение группы Microsoft 365 и параметры подготовки.

Возвращается по умолчанию. Поддерживает $filter (eq, not, startsWith).
securityEnabled Логический Указывает, является ли эта группа группой безопасности. Обязательный.

Возвращается по умолчанию. Поддерживает $filter (eq, ne, not, in).
securityIdentifier String Идентификатор безопасности группы, используемый в сценариях Windows. Только для чтения.

Возвращается по умолчанию.
serviceProvisioningErrors Коллекция serviceProvisioningError Ошибки, опубликованные федеративной службой, описывающие невременную ошибку, относящуюся к конкретной службе, в отношении свойств или ссылки из объекта группы.

Поддерживает $filter (eq, notдля isResolved и serviceInstance).
theme String Указывает цветовую тему группы Microsoft 365. Возможные значения: Teal, Purple, Green, OrangeBluePinkили .Red

Возвращается по умолчанию.
uniqueName Строка Уникальный идентификатор, который можно назначить группе и использовать в качестве альтернативного ключа. Неизменяемый. Только для чтения.
unseenConversationsCount Int32 Количество бесед, в которых было предоставлено одно или несколько новых сообщений с момента последнего посещения группы вошедшим в систему пользователем. Это свойство совпадает с unseenCount.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
unseenCount Int32 Количество бесед с новыми сообщениями, полученными с момента последнего посещения группы вошедшим в систему пользователем. Это свойство совпадает с unseenConversationsCount.

Требуется $select получение. Поддерживается только для API получения группы (GET /groups/{ID}).
unseenMessagesCount 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, вызывающий пользователь (администратор или не администратор) автоматически назначается владельцем группы.
  • Пользователь, не являющийся администратором, не может явно добавить себя в эту коллекцию при создании группы. Дополнительные сведения см. в описании соответствующей известной проблемы.
  • Для групп безопасности администратор не добавляется в эту коллекцию автоматически. Дополнительные сведения см. в описании соответствующей известной проблемы.

    Поддерживает $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1); Поддерживает $expand , в том числе, вложенные $select. Например, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
    		•
    photo; profilePhoto Фотография профиля группы.
    photos Коллекция объектов profilePhoto Фотографии профиля, принадлежащие группе. Только для чтения. Допускается значение null.
    planner plannerGroup Точка входа в ресурс Planner, который может существовать для единой группы.
    rejectedSenders Коллекция directoryObject Список пользователей или групп, которым запрещено создавать записи или события календаря в этой группе. Допускается значение null
    settings Коллекция объектов groupSetting Параметры, которые могут управлять поведением этой группы, например, могут ли ее участники приглашать гостей в группу. Допускается значение null.
    sites Коллекция объектов site Список сайтов SharePoint в этой группе. Откройте сайт по умолчанию с помощью /sites/root.
    team Коллекция channel Команда, связанная с этой группой.
    threads Коллекция conversationThread Цепочки бесед группы. Допускается значение null.
    transitiveMemberOf Коллекция directoryObject Группы, участником которых является группа (напрямую или через вложенное членство). Допускается значение null.
    transitiveMembers Коллекция directoryObject Непосредственные и транзитивные участники группы. Допускается значение null.

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

    В следующем представлении JSON показан тип ресурса.

    {
  "accessType": "String",
  "allowExternalSenders": "Boolean",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "autoSubscribeNewMembers": "Boolean",
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "classification": "String",
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdDateTime": "String (timestamp)",
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "deletedDateTime":  "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "groupTypes": ["String"],
  "hasMembersWithLicenseErrors": "Boolean",
  "hideFromAddressLists": "Boolean",
  "hideFromOutlookClients": "Boolean",
  "id": "String (identifier)",
  "isAssignableToRole": "Boolean",
  "isFavorite": "Boolean",
  "isManagementRestricted": "Boolean",
  "isSubscribedByMail": "Boolean",
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": "Boolean",
  "mailNickname": "String",
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": { "@odata.type": "microsoft.graph.onPremisesExtensionAttributes" },
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "String",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": "Boolean",
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "uniqueName": "String",
  "unseenConversationsCount": "Int32",
  "unseenCount": "Int32",
  "unseenMessagesCount": "Int32",
  "visibility": "String"
}

    Связанные материалы

    • Last updated on