Тип ресурса group
Пространство имен: microsoft.graph
Представляет группу Azure Active Directory (Azure AD), которая может быть группой Microsoft 365 или группой безопасности. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.
Наследуется от directoryObject.
Чтобы повысить производительность, операции create, get и list возвращают только подмножество часто используемых свойств по умолчанию. Эти свойства по умолчанию указаны в разделе Свойства. Чтобы получить любые свойства, которые не возвращаются по умолчанию, укажите их в параметре запроса OData $select
.
Этот ресурс поддерживает:
- добавление собственных данных к настраиваемым свойствам в виде расширений;
- подписку на уведомления об изменениях;
- отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
Методы
Метод | Возвращаемый тип | Описание |
---|---|---|
Управление группами | ||
Создание группы | group | Создание группы. Это может быть группа Microsoft 365, группа безопасности или динамическая группа. |
Получение группы | group | Считывание свойств объекта group. |
Список групп | Коллекция group | Список объектов group и их свойств. |
Обновление группы | Нет | Обновление свойств объекта group. |
Удаление группы | Нет | Удаление объекта group. |
delta | Коллекция group | Получение добавочных изменений для групп. |
Добавление участников | Нет | Добавление пользователя или группы в данную группу путем помещения в свойство навигации members (поддерживается только для групп безопасности и групп Microsoft 365). |
Добавление владельцев | Нет | Добавление владельца группы путем помещения в свойство навигации owners (поддерживается только для групп безопасности и групп Microsoft 365). |
Создание параметра | groupSetting | Создание параметра объекта на базе groupSettingTemplate. POST-запрос должен предоставлять объекты settingValue для всех параметров, определенных в шаблоне. В случае этой операции могут использоваться только шаблоны специально для групп. |
Удаление параметра | Нет | Удаление объекта setting. |
Получение параметра | groupSetting | Считывание свойств определенного объекта setting. |
Перечисление groupLifecyclePolicies | Коллекция groupLifecyclePolicy | Перечисление политик жизненного цикла для групп. |
Перечисление участников | Коллекция directoryObject | Получение непосредственных участников этой группы из свойства навигации members. |
Перечисление владельцев | Коллекция directoryObject | Получение владельцев группы из свойства навигации owners. |
Перечисление параметров | Коллекция объектов groupSetting | Перечисление свойств всех объектов setting. |
Перечисление транзитивных участников | Коллекция directoryObject | Получение пользователей, групп и устройств, являющихся участниками, включая вложенных участников этой группы. |
Перечисление транзитивных свойств memberOf | Коллекция directoryObject | Перечисление групп, в которых состоит эта группа. Эта операция является транзитивной и включает группы, в которых эта группа является вложенным элементом. |
Удаление участника | Нет | Удаление участника из группы Microsoft 365 или группы безопасности с помощью свойства навигации members. |
Удаление владельца | Нет | Удаление владельца из группы Microsoft 365 или группы безопасности с помощью свойства навигации owners. |
Обновление параметра | groupSetting | Обновление объекта setting. |
assignLicense | group | Добавление или удаление подписок группы. Можно также включать и отключать отдельные планы, связанные с подпиской. |
renew | Boolean | Обновление, продлевающее срок действия группы. Когда группа обновляется, срок ее действия продляется на количество дней, определенное политикой. |
validateProperties | JSON | Проверка соответствия отображаемого имени или почтового псевдонима группы Microsoft 365 политикам именования. |
Назначение ролей приложений | ||
Перечисление appRoleAssignments | Коллекция appRoleAssignment | Получение приложений и ролей приложений, назначенных группе. |
Добавление объекта appRoleAssignment | appRoleAssignment | Назначение роли приложения группе. |
Удаление объекта appRoleAssignment | Нет. | Удаление назначения роли приложения из группы. |
Calendar | ||
Создание события | event | Создание объекта event путем публикации в коллекции объектов event. |
Получение события | event | Считывание свойств объекта event. |
Перечисление событий | Коллекция event | Получение коллекции объектов event. |
Обновление события | Нет | Обновление свойств объекта event. |
Удаление события | Нет | Удаление объекта event. |
Список calendarView | Коллекция event | Получение коллекции событий за указанный интервал времени. |
Беседы | ||
Создание беседы | conversation | Создание беседы путем публикации в коллекции объектов conversation. |
Получение беседы | conversation | Считывание свойств объекта conversation. |
Перечисление бесед | Коллекция conversation | Получение коллекции объектов conversation. |
Удаление беседы | Нет | Удаление объекта conversation. |
Создание цепочки | conversationThread | Создание цепочки беседы. |
Получение цепочки | conversationThread | Считывание свойств объекта thread. |
Перечисление цепочек | Коллекция conversationThread | Получение всех цепочек группы. |
Обновление цепочки | Нет | Обновление свойств объекта thread. |
Удаление цепочки | Нет | Удаление объекта thread. |
Вывод acceptedSenders | Коллекция directoryObject | Получение списка пользователей или групп, включенных в список утвержденных отправителей для этой группы. |
Добавление acceptedSender | directoryObject | Добавление User или Group в коллекцию acceptedSenders. |
Удаление acceptedSender | directoryObject | Удаление User или Group из коллекции acceptedSenders. |
Список rejectedSenders | Коллекция directoryObject | Получение списка пользователей или групп, включенных в список запрещенных отправителей для этой группы. |
Добавление rejectedSender | directoryObject | Добавление User или Group в коллекцию rejectedSenders. |
Удаление rejectedSender | directoryObject | Удаление нового объекта User или Group из коллекции объектов rejectedSender. |
Создание параметра | groupSetting | Создание параметра объекта на базе groupSettingTemplate. POST-запрос должен предоставлять объекты settingValue для всех параметров, определенных в шаблоне. В случае этой операции могут использоваться только шаблоны специально для групп. |
Объекты каталога | ||
Перечисление удаленных групп | Коллекция directoryObject | Получение групп, удаленных в клиенте за последние 30 дней. |
Перечисление удаленных групп, принадлежащих пользователю | Коллекция directoryObject | Получение групп, принадлежащих пользователю, которые удалены в клиенте за последние 30 дней. |
Получение удаленной группы | Коллекция directoryObject | Получение удаленной группы по идентификатору. |
Восстановление удаленной группы | Коллекция directoryObject | Восстановление группы, удаленной в клиенте за последние 30 дней. |
Удаление группы без возможности восстановления | Коллекция directoryObject | Окончательное удаление группы из клиента. |
checkMemberGroups | Коллекция String | Проверка участия в списке групп. Это транзитивная функция. |
getMemberGroups | Коллекция String | Возврат всех групп, в которых состоит эта группа. Это транзитивная функция. |
checkMemberObjects | Коллекция String | Проверка участия в списке группы, роли каталога или объектах административных единиц. Эта функция транзитивна. |
getMemberObjects | Коллекция String | Возвращение всех групп и административных единиц, в которых состоит группа. Это транзитивная функция. |
Параметры группы | ||
Получение параметра | groupSetting | Считывание свойств определенного объекта setting. |
Перечисление параметров | Коллекция объектов groupSetting | Перечисление свойств всех объектов setting. |
Обновление параметра | Нет | Обновление объекта параметра. |
Удаление параметра | Нет | Удаление объекта параметра. |
Получение шаблона параметров | Нет | Чтение свойств шаблона параметров. |
Перечисление шаблонов параметров | Нет | Перечисление свойств всех шаблонов параметров. |
Открытые расширения | ||
Создание открытого расширения | openTypeExtension | Создание открытого расширения и добавление настраиваемых свойств в новый или существующий ресурс. |
Получение открытого расширения | Коллекция объектов openTypeExtension | Получение открытого расширения, определяемого именем расширения. |
Расширения схемы | ||
Добавление значений расширений для схемы | Нет | Создание определения расширения схемы и его дальнейшее использование для добавления в ресурс введенных пользовательских данных. |
Другие ресурсы групп | ||
Перечисление фотографий | Коллекция объектов profilePhoto | Получение коллекции фотографий профиля для группы. |
Перечисление планов | Коллекция объектов plannerPlan | Получение планов, принадлежащих группе. |
Параметры пользователя | ||
addFavorite | Нет | Добавление группы в список избранных групп пользователя, выполнившего вход. Поддерживается только для групп Microsoft 365. |
removeFavorite | Нет | Удаление группы из списка избранных групп пользователя, выполнившего вход. Поддерживается только для групп Microsoft 365. |
Перечисление memberOf | Коллекция directoryObject | Получение групп и административных единиц, непосредственным участником которых является пользователь, из свойства навигации memberOf. |
subscribeByMail | Нет | Задает значение true для свойства isSubscribedByMail. Позволяет вошедшему в систему пользователю получать беседы по электронной почте. Поддерживается только для групп Microsoft 365. |
unsubscribeByMail | Нет | Задает значение false для свойства isSubscribedByMail. Отключает получение бесед по электронной почте для вошедшего в систему пользователя. Поддерживается только для групп Microsoft 365. |
resetUnseenCount | Нет | Сброс до 0 значения unseenCount — счетчика всех записей, которые пользователь, выполнивший вход, не просматривал со времени последнего посещения. Поддерживается только для групп Microsoft 365. |
Свойства
Важно!
Определенное использование $filter
и параметра запроса $search
поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual
и $count
. Дополнительные сведения см. в статье Расширенные возможности запросов для объектов каталога Azure AD.
Свойство | Тип | Описание |
---|---|---|
allowExternalSenders | Логическое | Указывает, могут ли пользователи за пределами организации отправлять сообщения в группу. Значение по умолчанию: false .Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
assignedLabels | Коллекция assignedLabel | Список пар меток конфиденциальности (идентификатор метки, имя метки), связанных с группой Microsoft 365. Возвращается только с помощью оператора $select . Только для чтения. |
assignedLicenses | Коллекция assignedLicense | Лицензии, назначенные группе. Возвращается только с помощью оператора $select . Поддерживает $filter (eq ). Только для чтения. |
autoSubscribeNewMembers | Boolean | Указывает, будут ли новые члены группы автоматически подписаны на получение уведомлений по электронной почте. Это свойство можно задать в запросе PATCH для группы. Не задавайте его в первоначальном запросе POST, создающем группу. Значение по умолчанию: false .Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
classification | String | Описывает классификацию для группы (например, незначительное, среднее или значительное влияние на бизнес). Допустимые значения для этого свойства определяются созданием значения setting ClassificationList на базе определения шаблона. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , startsWith ). |
createdDateTime | DateTimeOffset | Метка времени создания группы. Значение не может изменяться и заполняется автоматически, когда создается группа. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in ). Только для чтения. |
deletedDateTime | DateTimeOffset | При удалении некоторых объектов Azure Active Directory (пользователя, группы, приложения) сначала происходит логическое удаление, а это свойство обновляется в соответствии с датой и временем удаления объекта. В противном случае этому свойству присваивается значение null . При восстановлении объекта значение этого свойства обновляется до null . |
description | String | Необязательное описание для группы. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , startsWith ) и $search . |
displayName | String | Отображаемое имя для группы. Это свойство необходимо при создании группы и не может быть удалено во время обновления. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith и eq для значений null ), $search и $orderBy . |
expirationDateTime | DateTimeOffset | Метка времени завершения срока действия группы. Значение не может изменяться и заполняется автоматически, когда создается группа. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in ). Только для чтения. |
groupTypes | Коллекция String | Задает тип группы и участие в ней. Если коллекция содержит объект Unified , эта группа является группой Microsoft 365. В противном случае она является группой безопасности или группой рассылки. Дополнительные сведения см. в обзоре групп.Если коллекция включает объект DynamicMembership , в этой группе используется динамическое участие. В противном случае участие является статическим. Возвращается по умолчанию. Поддерживает $filter (eq , not ). |
hasMembersWithLicenseErrors | Логический | Указывает, есть ли в этой группе участники с ошибками лицензий после группового назначения лицензий. Это свойство никогда не возвращается для операций GET. Его можно использовать в качестве аргумента $filter для получения групп, включающих участников с ошибками лицензии (то есть фильтру для этого свойства присвоено значение true). См. пример. Поддерживает $filter (eq ). |
hideFromAddressLists | Boolean | Значение true указывает, что группа не отображается в определенных частях пользовательского интерфейса Outlook: в адресной книге, в списках адресов для выбора получателей сообщений и в диалоговом окне Обзор групп для поиска групп. В противном случае используется значение false. Значение по умолчанию: false .Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
hideFromOutlookClients | Boolean | Значение true указывает, что группа не отображается в клиентах Outlook, например Outlook для Windows и Outlook в Интернете. В противном случае используется значение false. Значение по умолчанию: false .Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
id | String | Уникальный идентификатор группы. Возвращается по умолчанию. Наследуется от directoryObject. Ключ. Значение null не допускается. Только для чтения. Поддерживает $filter (eq , ne , not , in ). |
isArchived | Boolean | Когда группа связана с командой, это свойство определяет, находится ли команда в режиме "только для чтения". |
isAssignableToRole | Логическое | Указывает, можно ли эту группу назначить роли Azure Active Directory. Необязательно. Это свойство можно настроить только при создании группы, и оно является неизменяемым. Если присвоено значение true , свойству securityEnabled также должно быть присвоено значение true , а группа не может быть динамической (то есть groupTypes не может содержать DynamicMembership ). Только вызывающие с ролями глобального администратора и администратора привилегированных ролей могут настроить это свойство. Вызывающему должно быть назначено разрешение RoleManagement.ReadWrite.Directory для настройки этого свойства или обновления участников таких групп. Дополнительные сведения см. в статье Использование группы для управления назначениями ролей Azure ADВозвращается по умолчанию. Поддерживает $filter (eq , ne , not ). |
isSubscribedByMail | Логический | Указывает, подписан ли вошедший пользователь на получение бесед по электронной почте. Значение по умолчанию: true .Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
licenseProcessingState | String | Указывает состояние назначения лицензии группы для всех участников группы. Значение по умолчанию: false . Только для чтения. Возможные значения: QueuedForProcessing , ProcessingInProgress и ProcessingComplete .Возвращается только с помощью оператора $select . Только для чтения. |
почта; | String | SMTP-адрес группы, например "serviceadmins@contoso.onmicrosoft.com". Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith и eq по null значениям). |
mailEnabled | Логический | Указывает, включена ли для этой группы поддержка почты. Обязательно. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not ). |
mailNickname | String | Почтовый псевдоним для группы, уникальный для групп Microsoft 365 в организации. Максимальная длина: 64 символа. Это свойство может содержать только символы из набора символов ASCII от 0 до 127, за исключением следующих: @ () \ [] " ; : . <> , SPACE . Обязательный. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith и eq для значений null ). |
membershipRule | String | Правило, определяющее участников этой группы, если группа является динамической (groupTypes содержит DynamicMembership ). Дополнительные сведения о синтаксисе правила участия см. в здесь. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , startsWith ). |
membershipRuleProcessingState | String | Указывает, включена или приостановлена динамическая обработка участия. Возможные значения: On и Paused .Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , in ). |
onPremisesLastSyncDateTime | DateTimeOffset | Указывает время последней синхронизации группы с локальным каталогом. Тип Timestamp представляет сведения о времени и дате в формате ISO 8601 (время всегда указывается в формате UTC). Например, полночь 1 января 2014 г. в формате UTC представляется в виде 2014-01-01T00:00:00Z .Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq , ne , not , ge , le , in ). |
onPremisesProvisioningErrors | Коллекция onPremisesProvisioningError | Ошибки при использовании продукта синхронизации Майкрософт во время подготовки. Возвращается по умолчанию. Поддерживает $filter (eq , not ). |
onPremisesSamAccountName | String | Содержит локальное имя учетной записи SAM, синхронизированное из локального каталога. Это свойство заполняется только для клиентов, синхронизирующих свой локальный каталог с Azure Active Directory через Azure AD Connect. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith ). Только для чтения. |
onPremisesSecurityIdentifier | String | Содержит локальный идентификатор безопасности (SID) для локальной группы, синхронизированной с облаком. Возвращается по умолчанию. Поддерживает $filter (eq в том числе null значений). Только для чтения. |
onPremisesSyncEnabled | Boolean | Значение true указывает, что эта группа синхронизируется из локального каталога. Значение false указывает, что эта группа ранее синхронизировалась из локального каталога, но синхронизация больше не выполняется. Значение null указывает, что этот объект никогда не синхронизировался из локального каталога (значение по умолчанию). Возвращается по умолчанию. Только для чтения. Поддерживает $filter (eq , ne , not , in и eq по null значениям). |
preferredDataLocation | String | Предпочтительное расположение данных для группы Microsoft 365. По умолчанию группа наследует предпочтительное расположение данных создателя группы. Чтобы настроить это свойство, вызывающему пользователю должна быть назначена одна из указанных ниже ролей Azure AD.
Дополнительные сведения об этом свойстве см. в статье OneDrive Online с поддержкой нескольких регионов. Допускает значение NULL. Возвращается по умолчанию. |
preferredLanguage | String | Предпочтительный язык для группы Microsoft 365. Должен быть представлен в формате ISO 639-1, например en-US .Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in , startsWith и eq для значений null ). |
proxyAddresses | Коллекция String | Адреса электронной почты для группы, ведущие в один почтовый ящик группы. Пример: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] . Для фильтрации выражений по многозначным свойствам требуется оператор any. Возвращается по умолчанию. Только для чтения. Значение null не допускается. Поддерживает $filter (eq , not , ge , le , startsWith , endsWith и подсчет пустых коллекций). |
renewedDateTime | DateTimeOffset | Метка времени последнего обновления группы. Не может изменяться непосредственно. Обновляется только при выполнении действия обновления. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , ge , le , in ). Только для чтения. |
resourceBehaviorOptions | Коллекция объектов string | Определяет поведение группы, которое может быть задано для группы Microsoft 365 во время ее создания. Это можно сделать только в рамках операции создания (POST). Возможные значения: AllowOnlyMembersToPost , HideGroupInOutlook , SubscribeNewGroupMembers , WelcomeEmailDisabled . Дополнительные сведения см. в статье Настройка вариантов поведения и подготовки групп Microsoft 365. |
resourceProvisioningOptions | Коллекция объектов string | Определяет ресурсы группы, которые были подготовлены в рамках создания групп Microsoft 365 и обычно не являются частью процесса создания группы по умолчанию. Возможное значение: Team . Дополнительные сведения см. в статье Настройка вариантов поведения и подготовки групп Microsoft 365. |
securityEnabled | Boolean | Указывает, является ли эта группа группой безопасности. Обязательно. Возвращается по умолчанию. Поддерживает $filter (eq , ne , not , in ). |
securityIdentifier | String | Идентификатор безопасности группы, используемый в сценариях Windows. Возвращается по умолчанию. |
theme | String | Указывает цветовую тему группы Microsoft 365. Возможные значения: Teal , Purple , Green , Blue , Pink , Orange или Red . Возвращается по умолчанию. |
unseenCount | Int32 | Количество бесед с новыми сообщениями, полученными с момента последнего посещения группы вошедшим в систему пользователем. Возвращается только в $select . Поддерживается только для API получения группы (GET /groups/{ID} ). |
visibility | String | Указывает политику присоединения к группе и видимость содержимого для групп. Возможные значения: Private , Public или Hiddenmembership . Hiddenmembership задается только для Групп Microsoft 365 при их создании. Обновление невозможно выполнить позже. Другие значения видимости можно обновлять после создания группы.Если при создании группы в Microsoft Graph не задается значение видимости, группа безопасности по умолчанию создается как Private , а группа Microsoft 365 —Public . Группы, которые можно назначить ролям, всегда являются Private . Дополнительные сведения см. в разделе Параметры видимости группы. Возвращается по умолчанию. Допускает значение NULL. |
Параметры видимости группы
Значение | Описание |
---|---|
Public | К группе может присоединиться любой пользователь без необходимости разрешения владельца. Любой пользователь может просматривать атрибуты группы. Любой пользователь может просматривать участников группы. |
Private | Чтобы присоединиться к группе, требуется разрешение владельца. Пользователи, не являющиеся участниками группы, не могут просматривать ее атрибуты. Любой пользователь может просматривать участников группы. |
Hiddenmembership | Чтобы присоединиться к группе, требуется разрешение владельца. Пользователи, не являющиеся участниками группы, не могут просматривать ее атрибуты. Пользователи, не являющиеся участниками группы, не могут просматривать ее участников. Администраторы (глобальные, организации, пользователей и службы поддержки) могут просматривать список участников группы. Группа отображается в глобальной адресной книге (глобальном списке адресов). |
Связи
Связь | Тип | Описание |
---|---|---|
acceptedSenders | Коллекция directoryObject | Список пользователей или групп, которым разрешено создавать записи или события календаря в этой группе. Если этот список не пуст, то добавлять записи разрешено только перечисленным в нем пользователям и группам. |
appRoleAssignments | Коллекция appRoleAssignment | Представляет роли группе, предоставленные пользователю для приложения. Поддерживает $expand . |
calendar | calendar | Календарь группы. Только для чтения. |
calendarView | Коллекция event | Представление календаря. Только для чтения. |
conversations | Коллекция conversation | Беседы группы. |
createdOnBehalfOf | directoryObject | Пользователь или приложение, создавшие группу. ПРИМЕЧАНИЕ. Это значение не задается, если пользователь является администратором. Только для чтения. |
drive | drive | Используемый по умолчанию диск группы. Только для чтения. |
drives | Коллекция drive | Диски группы. Только для чтения. |
events | Коллекция event | События в календаре группы. |
extensions | Коллекция extension | Коллекция открытых расширений, определенных для группы. Только для чтения. Допускается значение null. |
groupLifecyclePolicies | Коллекция groupLifecyclePolicy | Коллекция политик жизненного цикла для этой группы. Только для чтения. Допускается значение NULL. |
memberOf | Коллекция directoryObject | Группы, в которых состоит эта группа. Методы HTTP: GET (поддерживается для всех групп). Только для чтения. Допускается значение NULL. Поддерживает $expand . |
members | Коллекция directoryObject | Участники этой группы, которые могут быть пользователями, устройствами, другими группами или субъектами-службы. Поддерживает операции Перечисление участников, Добавление участника и Удаление участника. Допускается значение null. Поддерживает $expand , включая вложенные $select . Например, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName) . |
membersWithLicenseErrors | Коллекция User | Список участников группы с ошибками лицензий в этом групповом назначении лицензий. Только для чтения. |
onenote | Onenote | Только для чтения. |
owners | Коллекция directoryObject | Владельцы группы. Максимальное количество владельцев: 100. Допускается значение NULL. Если это свойство не указано при создании группы Microsoft 365, вызывающий пользователь автоматически назначается владельцем группы. Поддерживает $expand , включая вложенные $select . Например, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName) . |
permissionGrants | resourceSpecificPermissionGrant | Разрешение, предоставленное группе для определенного приложения. Поддерживает $expand . |
photo; | profilePhoto | Фотография профиля группы. |
photos | Коллекция объектов profilePhoto | Фотографии профиля, принадлежащие группе. Только для чтения. Допускается значение null. |
planner | plannerGroup | Точка входа в ресурс Planner, который может существовать для единой группы. |
rejectedSenders | Коллекция directoryObject | Список пользователей или групп, которым запрещено создавать записи или события календаря в этой группе. Допускается значение null. |
settings | Коллекция объектов groupSetting | Параметры, управляющие поведением группы, например, могут ли участники приглашать гостевых пользователей в группу. Допускается значение NULL. |
sites | Коллекция объектов site | Список сайтов SharePoint в этой группе. Для доступа к сайту по умолчанию используйте путь /sites/root. |
team | Коллекция channel | Команда, связанная с этой группой. |
threads | Коллекция conversationThread | Цепочки бесед группы. Допускается значение null. |
Представление JSON
Ниже указано представление ресурса в формате JSON.
{
"allowExternalSenders": false,
"assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
"autoSubscribeNewMembers": true,
"classification": "String",
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"groupTypes": ["String"],
"hasMembersWithLicenseErrors": "Boolean",
"hideFromAddressLists": false,
"hideFromOutlookClients": false,
"id": "String (identifier)",
"isSubscribedByMail": true,
"isAssignableRole": false,
"licenseProcessingState": "String",
"mail": "String",
"mailEnabled": true,
"mailNickname": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesProvisioningErrors": [
{ "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
],
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
"preferredDataLocation": "String",
"proxyAddresses": ["String"],
"renewedDateTime": "String (timestamp)",
"resourceBehaviorOptions": ["String"],
"resourceProvisioningOptions": ["String"],
"securityEnabled": true,
"securityIdentifier": "String",
"unseenCount": 1024,
"visibility": "String",
"acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"calendar": { "@odata.type": "microsoft.graph.calendar" },
"calendarView": [{ "@odata.type": "microsoft.graph.event" }],
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
"createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
"drive": { "@odata.type": "microsoft.graph.drive" },
"events": [{ "@odata.type": "microsoft.graph.event" }],
"memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
"owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"sites": [{ "@odata.type": "microsoft.graph.site" }],
"threads": [{ "@odata.type": "microsoft.graph.conversationThread" }]
}
См. также
Обратная связь
Отправить и просмотреть отзыв по