Поделиться через


Тип ресурса group

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

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

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

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

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

Методы

Метод Возвращаемый тип Описание
Список Коллекция group Список объектов group и их свойств.
Создание group Создание группы. Это может быть группа Microsoft 365, группа безопасности или динамическая группа.
получение; group Считывание свойств объекта group.
Обновление Нет Обновление свойств объекта group.
Upsert group Создайте новую группу, если она не существует, или обновите свойства существующей группы.
удаление; Нет Удаление объекта group.
Получение дельты Коллекция group Получение добавочных изменений для групп.
Управление группами
Перечисление участников Коллекция directoryObject Получение непосредственных участников этой группы из свойства навигации members.
Добавление участников Нет Добавьте участника в эту группу, опубликовав его в свойстве навигации members (поддерживается только для групп безопасности и групп Microsoft 365).
Удаление участника Нет Удаление участника из группы Microsoft 365 или группы безопасности с помощью свойства навигации members.
Список владельцев Коллекция directoryObject Получение владельцев группы из свойства навигации owners.
Добавление владельцев Нет Добавление владельца группы путем помещения в свойство навигации owners (поддерживается только для групп безопасности и групп Microsoft 365).
Удаление владельца Нет Удаление владельца из группы Microsoft 365 или группы безопасности с помощью свойства навигации owners.
Перечисление политик жизненного цикла группы Коллекция groupLifecyclePolicy Перечисление политик жизненного цикла для групп.
Перечисление транзитивных участников Коллекция directoryObject Получение пользователей, групп и устройств, которые являются участниками, включая вложенных членов этой группы.
Перечисление транзитивного элемента Коллекция directoryObject Перечисление групп, в которых состоит эта группа. Эта операция является транзитивной и включает группы, в которых эта группа является вложенным элементом.
Назначение лицензии 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.
Обновление Нет Обновление объекта параметра.
удаление; Нет Удаление объекта setting.
Перечисление шаблонов параметров Нет Перечисление свойств всех шаблонов параметров.
Получение шаблона параметров Нет Чтение свойств шаблона параметров.
Примечания.
Список записных книжек Коллекция объектов notebook Получение списка объектов notebook.
Создание записной книжки notebook Создание записной книжки OneNote.
Фотография профиля
Получение profilePhoto Получение указанного объекта profilePhoto или его метаданных (свойств profilePhoto).
Обновление Нет Обновление фотографии любого пользователя в клиенте, в том числе пользователя, выполнившего вход, либо указанной группы или контакта.
удаление; Нет Удалите фотографию любого пользователя в клиенте, включая пользователя, выполнившего вход, или указанную группу.
Планировщик
Список планов Коллекция объектов 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. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.

Свойство Тип Описание
allowExternalSenders Логический Указывает, могут ли пользователи за пределами организации отправлять сообщения в группу. Значение по умолчанию — false.

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

Возвращается только с помощью оператора $select. Это свойство можно обновить только в делегированных сценариях, когда вызывающей стороне требуется разрешение Microsoft Graph и поддерживаемая роль администратора.
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 он представляет, когда срок действия группы истекает, как определено в groupLifecyclePolicycy. Тип Timestamp представляет сведения о дате и времени в формате 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, видимость должна иметь значение Hidden, а группа не может быть динамической группой (то есть groupTypes не может содержать DynamicMembership).

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

Для использования этой функции требуется лицензия Microsoft Entra ID P1. Возвращается по умолчанию. Поддерживает $filter (eq, ne, not).
isSubscribedByMail Логический Указывает, подписан ли вошедший пользователь на получение бесед по электронной почте. Значение по умолчанию — true.

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

Возвращается только с помощью оператора $select. Только для чтения.
mail String SMTP-адрес для группы, например "[email protected]".

Возвращается по умолчанию. Только для чтения. Поддерживает $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.

Возвращается по умолчанию. Только для чтения.
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: [email protected]", "smtp: [email protected]"]. Для фильтрации выражений по многозначным свойствам требуется оператор any.

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

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

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

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

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

Возвращается по умолчанию.
uniqueName Строка Уникальный идентификатор, который можно назначить группе и использовать в качестве альтернативного ключа. Неизменяемый. Только для чтения.
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, то вызывающий пользователь (администратор или не администратор) автоматически назначается в качестве владельца группы.
  • Пользователь без прав администратора не может явно добавить себя в эту коллекцию при создании группы. Дополнительные сведения см. в статье Об известной проблеме.
  • Для групп безопасности пользователь-администратор не добавляется в эту коллекцию автоматически. Дополнительные сведения см. в статье Об известной проблеме.

    Поддерживает $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 показан тип ресурса.

    {
      "allowExternalSenders": false,
      "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
      "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
      "autoSubscribeNewMembers": true,
      "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": false,
      "hideFromOutlookClients": false,
      "id": "String (identifier)",
      "isAssignableToRole": false,
      "isSubscribedByMail": true,
      "licenseProcessingState": "String",
      "mail": "String",
      "mailEnabled": true,
      "mailNickname": "String",
      "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
      "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
      "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
      "onPremisesDomainName": "String",
      "onPremisesLastSyncDateTime": "String (timestamp)",
      "onPremisesNetBiosName": "String",
      "onPremisesProvisioningErrors": [
        { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
      ],
      "onPremisesSecurityIdentifier": "String",
      "onPremisesSyncEnabled": true,
      "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)",
      "securityEnabled": true,
      "securityIdentifier": "String",
      "serviceProvisioningErrors": [
        { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
      ],
      "sites": [{ "@odata.type": "microsoft.graph.site" }],
      "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
      "uniqueName": "String",
      "unseenCount": 1024,
      "visibility": "String"
    }