Тип ресурса group
Пространство имен: microsoft.graph
Представляет группу Microsoft Entra, группу Microsoft 365 или группу безопасности. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.
Наследуется от directoryObject.
Чтобы повысить производительность, операции create, get и list возвращают только подмножество часто используемых свойств по умолчанию. Эти свойства по умолчанию указаны в разделе Свойства. Чтобы получить любое из свойств, не возвращенных по умолчанию, укажите их в параметре $select
запроса OData.
Этот ресурс поддерживает:
- Добавление данных в пользовательские свойства в качестве расширений.
- подписку на уведомления об изменениях;
- отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
Методы
Метод | Возвращаемый тип | Описание |
---|---|---|
Управление группами | ||
Создание группы | group | Создание группы. Это может быть группа Microsoft 365, группа безопасности или динамическая группа. |
Получение группы | group | Считывание свойств объекта group. |
Список групп | Коллекция group | Список объектов group и их свойств. |
Обновление группы | Нет | Обновление свойств объекта group. |
Группа Upsert | group | Создайте новую группу, если она не существует, или обновите свойства существующей группы. |
Удаление группы | Нет | Удаление объекта group. |
delta | Коллекция group | Получение добавочных изменений для групп. |
Добавление участников | Нет | Добавьте участника в эту группу, опубликовав его в свойстве навигации members (поддерживается только для групп безопасности и групп Microsoft 365). |
Добавление владельцев | Нет | Добавление владельца группы путем помещения в свойство навигации owners (поддерживается только для групп безопасности и групп Microsoft 365). |
Перечисление groupLifecyclePolicies | Коллекция groupLifecyclePolicy | Перечисление политик жизненного цикла для групп. |
Перечисление участников | Коллекция directoryObject | Получение непосредственных участников этой группы из свойства навигации members. |
Перечисление владельцев | Коллекция directoryObject | Получение владельцев группы из свойства навигации owners. |
Перечисление транзитивных участников | Коллекция directoryObject | Получение пользователей, групп и устройств, являющихся участниками, включая вложенных участников этой группы. |
Перечисление транзитивных свойств memberOf | Коллекция directoryObject | Перечисление групп, в которых состоит эта группа. Эта операция является транзитивной и включает группы, в которых эта группа является вложенным элементом. |
Удаление участника | Нет | Удаление участника из группы Microsoft 365 или группы безопасности с помощью свойства навигации members. |
Удаление владельца | Нет | Удаление владельца из группы Microsoft 365 или группы безопасности с помощью свойства навигации owners. |
assignLicense | group | Добавление или удаление подписок группы. Вы также можете включать и отключать отдельные планы, связанные с подпиской. |
renew | Boolean | Обновляет срок действия группы. Когда группа обновляется, срок ее действия продляется на количество дней, определенное политикой. |
validateProperties | JSON | Проверка соответствия отображаемого имени или почтового псевдонима группы Microsoft 365 политикам именования. |
Назначение ролей приложений | ||
Перечисление appRoleAssignments | Коллекция appRoleAssignment | Получение приложений и ролей приложений, назначенных группе. |
Добавление объекта appRoleAssignment | appRoleAssignment | Назначение роли приложения группе. |
Удаление объекта appRoleAssignment | Нет. | Удаление назначения роли приложения из группы. |
Calendar | ||
Создание события | event | Создание объекта event путем публикации в коллекции объектов event. |
Получение события | event | Считывание свойств объекта event. |
Перечисление событий | Коллекция event | Получение коллекции объектов event. |
Обновление события | Нет | Обновление свойств объекта event. |
Удаление события | Нет | Удаление объекта event. |
Список calendarView | Коллекция event | Получение коллекции событий за указанный интервал времени. |
Беседы | ||
Создание беседы | conversation | Создание беседы путем публикации в коллекции объектов conversation. |
Получение беседы | conversation | Считывание свойств объекта conversation. |
Перечисление бесед | Коллекция conversation | Получение коллекции объектов conversation. |
Удаление беседы | Нет | Удаление объекта conversation. |
Создание цепочки | conversationThread | Создание цепочки беседы. |
Получение цепочки | conversationThread | Считывание свойств объекта thread. |
Перечисление цепочек | Коллекция conversationThread | Получение всех цепочек группы. |
Обновление цепочки | Нет | Обновление свойств объекта thread. |
Удаление цепочки | Нет | Удаление объекта thread. |
Вывод acceptedSenders | Коллекция directoryObject | Получение списка пользователей или групп, включенных в список утвержденных отправителей для этой группы. |
Добавление acceptedSender | directoryObject | Добавление User или Group в коллекцию acceptedSenders. |
Удаление acceptedSender | directoryObject | Удаление User или Group из коллекции acceptedSenders. |
Список rejectedSenders | Коллекция directoryObject | Получение списка пользователей или групп, включенных в список запрещенных отправителей для этой группы. |
Добавление rejectedSender | directoryObject | Добавление User или Group в коллекцию rejectedSenders. |
Удаление rejectedSender | directoryObject | Удаление нового объекта User или Group из коллекции объектов rejectedSender. |
Создание параметра | groupSetting | Создайте объект параметра на основе groupSettingTemplate. Запрос POST должен предоставить settingValues для всех параметров, определенных в шаблоне. Для этой операции можно использовать только шаблоны для групп. |
Объекты каталога | ||
Перечисление удаленных групп | Коллекция directoryObject | Получение групп, удаленных в клиенте за последние 30 дней. |
Перечисление удаленных групп, принадлежащих пользователю | Коллекция directoryObject | Получение групп, принадлежащих пользователю, которые удалены в клиенте за последние 30 дней. |
Получение удаленной группы | Коллекция directoryObject | Получение удаленной группы по идентификатору. |
Восстановление удаленной группы | Коллекция directoryObject | Восстановление группы, удаленной в клиенте за последние 30 дней. |
Удаление группы без возможности восстановления | Коллекция directoryObject | Окончательное удаление группы из клиента. |
checkMemberGroups | Коллекция строк | Проверка членства в списке групп. Это транзитивная функция. |
getMemberGroups | Коллекция String | Возврат всех групп, в которых состоит эта группа. Это транзитивная функция. |
checkMemberObjects | Коллекция String | Проверка участия в списке группы, роли каталога или объектах административных единиц. Это транзитивная функция. |
getMemberObjects | Коллекция String | Возвращает все группы и административные единицы, членом которыми является группа. Это транзитивная функция. |
Параметры группы | ||
Получение параметра | groupSetting | Считывание свойств определенного объекта setting. |
Перечисление параметров | Коллекция объектов groupSetting | Перечисление свойств всех объектов setting. |
Обновление параметра | Нет | Обновление объекта параметра. |
Удаление параметра | Нет | Удаление объекта параметра. |
Получение шаблона параметров | Нет | Чтение свойств шаблона параметров. |
Перечисление шаблонов параметров | Нет | Перечисление свойств всех шаблонов параметров. |
Открытые расширения | ||
Создание открытого расширения | openTypeExtension | Создание открытого расширения и добавление настраиваемых свойств в новый или существующий ресурс. |
Получение открытого расширения | Коллекция объектов openTypeExtension | Получение открытого расширения, определяемого именем расширения. |
Расширения схемы | ||
Добавление значений расширений для схемы | Нет | Создание определения расширения схемы и его дальнейшее использование для добавления в ресурс введенных пользовательских данных. |
Другие ресурсы групп | ||
Перечисление фотографий | Коллекция объектов profilePhoto | Получение коллекции фотографий профиля для группы. |
Перечисление планов | Коллекция объектов plannerPlan | Получение планов, принадлежащих группе. |
Перечисление объектов permissionGrant | Коллекция resourceSpecificPermissionGrant | Список разрешений, предоставленных приложениям для доступа к группе. |
Параметры пользователя | ||
addFavorite | Нет | Добавление группы в список избранных групп вошедшего пользователя. Поддерживается только для групп Microsoft 365. |
removeFavorite | Нет | Удаление группы из списка избранных групп вошедшего пользователя. Поддерживается только для групп Microsoft 365. |
Перечисление memberOf | Коллекция directoryObject | Получение групп и административных единиц, непосредственным участником которых является пользователь, из свойства навигации memberOf. |
Перечисление объектов joinedTeams | Коллекция group | Получение команд Microsoft Teams, непосредственным участником которых является пользователь. |
Перечисление связанных команд | коллекция associatedTeamInfo | Получите список объектов associatedTeamInfo в Microsoft Teams, с которыми связан пользователь. |
subscribeByMail | Нет | Задает для свойства isSubscribedByMail значение true . Позволяет вошедшему пользователю получать беседы по электронной почте. Поддерживается только для групп Microsoft 365. |
unsubscribeByMail | Нет | Задает для свойства isSubscribedByMail значение false . Отключает получение бесед по электронной почте для вошедшего пользователя. Поддерживается только для групп Microsoft 365. |
resetUnseenCount | Нет | Сброс значений unseenCount до 0 для всех записей, которые вошедший пользователь не просматривал со времени последнего посещения. Поддерживается только для групп Microsoft 365. |
Свойства
Важно!
Определенное использование $filter
и параметра запроса $search
поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual
и $count
. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.
Свойство | Тип | Описание |
---|---|---|
allowExternalSenders | Логический | Указывает, могут ли пользователи за пределами организации отправлять сообщения в группу. Значение по умолчанию — false . Возвращается только с помощью оператора $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
assignedLabels | Коллекция assignedLabel | Список пар меток конфиденциальности (идентификатор метки, имя метки), связанных с группой Microsoft 365. Возвращается только с помощью оператора $select . |
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). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Только для чтения. |
deletedDateTime | DateTimeOffset | Для некоторых Microsoft Entra объектов (пользователя, группы, приложения), если объект удален, сначала он логически удаляется, и это свойство обновляется с учетом даты и времени удаления объекта. В противном случае это свойство имеет значение null . При восстановлении объекта это свойство обновляется до null . |
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. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in ). Только для чтения. |
groupTypes | Коллекция String | Задает тип группы и участие в ней. Если коллекция содержит Unified , группа является группой Microsoft 365; в противном случае это группа безопасности или группа рассылки. Дополнительные сведения см. в статье Обзор групп.Если коллекция включает объект DynamicMembership , в этой группе используется динамическое участие. В противном случае участие является статическим. Возвращается по умолчанию. Поддерживает $filter (eq , not ). |
hasMembersWithLicenseErrors | Логический | Указывает, есть ли в этой группе участники с ошибками лицензий после группового назначения лицензий. Это свойство никогда не возвращается при использовании операции GET. Его можно использовать в качестве аргумента $filter для получения групп, включающих участников с ошибками лицензии (т. е. фильтру для этого свойства присвоено значчение true). См. пример. Поддерживает $filter (eq ). |
hideFromAddressLists | Логический | Значение 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-адрес для группы, например "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 ). |
onPremisesLastSyncDateTime | DateTimeOffset | Указывает время последней синхронизации группы с локальным каталогом. Тип Timestamp представляет сведения о дате и времени с использованием формата ISO 8601 (время всегда в формате UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq , ne , not , ge , le , in ). |
onPremisesProvisioningErrors | Коллекция onPremisesProvisioningError | Ошибки при использовании продукта синхронизации Майкрософт во время подготовки. Возвращается по умолчанию. Поддерживает $filter (eq , not ). |
onPremisesSamAccountName | String | Содержит локальный параметр SAM account name, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих локальный каталог с Microsoft Entra ID через Microsoft Entra Connect. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith ). Только для чтения. |
onPremisesSecurityIdentifier | String | Содержит локальный идентификатор безопасности (SID) для группы, синхронизированной из локальной среды в облако. Возвращается по умолчанию. Поддерживает $filter (eq в том числе null значений). Только для чтения. |
onPremisesSyncEnabled | Boolean | Значение true указывает, что эта группа синхронизируется из локального каталога. Значение false указывает, что эта группа ранее синхронизировалась из локального каталога, но синхронизация больше не выполняется. Значение null указывает, что этот объект никогда не синхронизировался из локального каталога (значение по умолчанию). Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq , ne , not , in и eq для значений null ). |
preferredDataLocation | String | Предпочтительное расположение данных для группы Microsoft 365. По умолчанию группа наследует предпочтительное расположение данных создателя группы. Чтобы задать это свойство, вызывающему приложению должно быть предоставлено разрешение 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: 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 | Метка времени последнего обновления группы. Не может изменяться непосредственно. Обновляется только при выполнении действия обновления. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 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 collection | Ошибки, опубликованные федеративной службой, описывающие не временную ошибку службы в отношении свойств или ссылки из объекта группы . Поддерживает $filter (eq , not , для isResolved и serviceInstance). |
theme | String | Указывает цветовую тему группы Microsoft 365. Возможные значения: Teal , Purple , Green , Blue , Pink , Orange или Red . Возвращается по умолчанию. |
uniqueName | Строка | Уникальный идентификатор, который можно назначить группе и использовать в качестве альтернативного ключа. Неизменяемый. Только для чтения. |
unseenConversationsCount | Int32 | Количество бесед, доставленных одной или несколькими новыми записями с момента последнего посещения группы пользователем, выполнившего вход. Это свойство совпадает с unseenCount. Возвращается только с помощью оператора $select . |
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" },
"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)",
"isAssignableRole": 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" }],
"onPremisesLastSyncDateTime": "String (timestamp)",
"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)",
"resourceBehaviorOptions": ["String"],
"resourceProvisioningOptions": ["String"],
"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"
}
Связанные материалы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по