Тип ресурса teamworkSection

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет раздел в списке чатов Microsoft Teams пользователя, который упорядочивает чаты, каналы и собрания в пользовательские или определяемые системой группы. Разделы могут быть определяемыми пользователем, что позволяет пользователям создавать, переименовывать и удалять их или определять систему, которые управляются службой.

Методы

Метод Тип возвращаемых данных Описание
Список коллекция teamworkSection Получение списка разделов в командной работе пользователя.
Создание teamworkSection Создайте новый раздел в командной работе пользователя.
Получение teamworkSection Чтение свойств раздела в командной работе пользователя.
Обновление teamworkSection Обновление свойств раздела в командной работе пользователя.
Delete Нет Удаление определяемого пользователем раздела из командной работы пользователя.
Элементы списка коллекция teamworkSectionItem Получение списка элементов в разделекомандной работы пользователя.

Свойства

Свойство Тип Описание
createdDateTime DateTimeOffset Дата и время создания раздела. Только для чтения. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2024 г. имеет значение 2024-01-01T00:00:00Z.
displayIcon sectionDisplayIcon Значок, отображаемый для раздела.
displayName String Отображаемое имя раздела. Обязательно. Максимальная длина — 50 символов. Отображаемые имена чувствительны к регистру и должны быть уникальными в разделах пользователя. Следующие имена зарезервированы для системных разделов и не могут использоваться при создании определяемого пользователем раздела: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, , . EngageCommunities
id String Уникальный идентификатор раздела. Только для чтения.
isExpanded Логический Указывает, развернут ли раздел в пользовательском интерфейсе. Значение по умолчанию — true.
isHierarchicalViewEnabled Логический Указывает, включено ли иерархическое представление для раздела. Только для чтения.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения раздела. Только для чтения. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2024 г. имеет значение 2024-01-01T00:00:00Z.
sectionType sectionType Тип раздела. Допустимые значения: userDefined, systemDefined, unknownFutureValue. Только для чтения.
sortType sectionSortType Порядок сортировки элементов в разделе. Допустимые значения зависят от sectionType. Допустимые значения: mostRecent, unreadThenMostRecent, nameAlphabetical, userDefinedCustomOrder, unknownFutureValue.

значения sectionType

Member Описание
userDefined Раздел, созданный пользователем, который можно переименовать, изменить порядок и удалить.
systemDefined Раздел, управляемый службой, который не может быть удален. Можно обновить только свойство sortType .
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Системные разделы

Определенные системой разделы подготавливаются службой и отображаются в списке разделов каждого пользователя. Их значения displayName зарезервированы и не могут использоваться для определяемых пользователем разделов.

displayName Описание
RecentChats Раздел чатов по умолчанию.
QuickViews Раздел Быстрые представления.
TeamsAndChannels Раздел "Команды и каналы".
MutedChats Раздел отключенных чатов.
MeetingChats Раздел чатов для собраний.
EngageCommunities Раздел "Сообщества".

Определенные системой разделы не могут быть удалены, и можно обновить только свойство sortType . Пытается обновить другие свойства или удалить системный раздел, возвращающий 403 Forbidden. Перечисление элементов в системном разделе не поддерживается и возвращает .400 Bad Request

значения sectionSortType

Member Описание
mostRecent Сортировка элементов по последним действиям. Допустимо для определяемых пользователем и большинства системных разделов.
unreadThenMostRecent Сначала отсортируйте непрочитанные элементы, а затем по последним действиям. Допустимо для определяемых пользователем и большинства системных разделов.
nameAlphabetical Сортировка элементов в алфавитном порядке по имени. Допустимо только для определенных системных разделов, таких как Teams и Каналы. Недопустимо для определяемых пользователем разделов.
userDefinedCustomOrder Сортировка элементов в соответствии с пользовательским порядком, определенным пользователем. Допустимо только для определяемых пользователем разделов. Это тип сортировки по умолчанию для новых пользовательских разделов.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Примечание.

Допустимые типы сортировки для системных разделов зависят от конкретного раздела. Например, разделы Teams и Каналы поддерживают nameAlphabetical, но разделы RecentChats и MutedChats поддерживают только mostRecent и unreadThenMostRecent. Если свойству isHierarchicalViewEnabled присвоено значение true для раздела Teams и каналов , допустимо только nameAlphabetical . Установка неподдерживаемого типа сортировки возвращает ошибку 400 Bad Request .

Атрибуты экземпляра

Атрибуты экземпляра — это свойства с особым поведением. Эти свойства — временные и а) определяют поведение выполнения службы; или б) предоставляют краткосрочные значения свойств, например URL-адрес скачивания элемента, у которого истекает срок действия.

Имя свойства Тип Описание
@microsoft.graph.sectionsOrder Коллекция строк Упорядоченный массив идентификаторов разделов, представляющих предпочтительный порядок разделов пользователя.
@microsoft.graph.sectionsVersion String Текущая версия иерархии разделов. Используйте это значение в качестве заголовка If-Match для управления оптимистическим параллелизмом при операциях изменения (создание, обновление или удаление разделов, а также добавление, удаление или перемещение элементов).

Связи

Связь Тип Описание
items коллекция teamworkSectionItem Элементы (чаты, каналы, собрания или сообщества), организованные в разделе.

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

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

{
  "@odata.type": "#microsoft.graph.teamworkSection",
  "createdDateTime": "String (timestamp)",
  "displayIcon": {"@odata.type": "microsoft.graph.sectionDisplayIcon"},
  "displayName": "String",
  "id": "String (identifier)",
  "isExpanded": "Boolean",
  "isHierarchicalViewEnabled": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "sectionType": "String",
  "sortType": "String"
}

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

  • Last updated on