Тип ресурса group
Пространство имен: microsoft.graph
Представляет группу Microsoft Entra, группу Microsoft 365 или группу безопасности. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.
Наследуется от directoryObject.
Чтобы повысить производительность, операции create, get и list возвращают только подмножество часто используемых свойств по умолчанию. Эти свойства по умолчанию указаны в разделе Свойства. Чтобы получить любое из свойств, не возвращенных по умолчанию, укажите их в параметре $select
запроса OData.
Этот ресурс поддерживает:
- Добавление данных в пользовательские свойства в качестве расширений.
- подписку на уведомления об изменениях;
- отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
Методы
Метод | Возвращаемый тип | Описание |
---|---|---|
Список | Коллекция 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 . Только для чтения. |
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 ролей:
Дополнительные сведения об этом свойстве см. в статье 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. Поддерживает $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"
}