Создание teamworkSection

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

Важно!

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

Создайте новый раздел в командной работе пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) TeamworkSection.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение TeamworkSection.ReadWrite.All Teamwork.Migrate.All

HTTP-запрос

POST /users/{user-id}/teamwork/sections

Заголовки запросов

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
If-Match Значение заметки @microsoft.graph.sectionsVersion , возвращаемой при перечислении разделов, или значение @odata.etag из любого ранее полученного раздела. Требуется для управления оптимистическим параллелизмом.

Текст запроса

В тексте запроса укажите представление объекта teamworkSection в формате JSON.

В следующей таблице перечислены свойства, которые можно задать при создании teamworkSection.

Свойство Тип Описание
displayIcon sectionDisplayIcon Значок, отображаемый для раздела. Необязательный параметр. Свойство skinTone значка не может быть задано и является производным от параметров пользователя.
displayName String Отображаемое имя раздела. Обязательно. Максимальная длина — 50 символов. Отображаемые имена чувствительны к регистру и должны быть уникальными в разделах пользователя. Следующие имена зарезервированы для системных разделов и не могут использоваться: RecentChats, QuickViews, , MutedChatsTeamsAndChannels, MeetingChats, , . EngageCommunities
isExpanded Логический Указывает, развернут ли раздел в пользовательском интерфейсе. Необязательный параметр. Значение по умолчанию — true.
sortType sectionSortType Порядок сортировки элементов в разделе. Необязательный параметр. Значение по умолчанию — userDefinedCustomOrder. Допустимые значения для определяемых пользователем разделов: mostRecent, , unreadThenMostRecentuserDefinedCustomOrder, , unknownFutureValue. Элемент nameAlphabetical недопустим для определяемых пользователем разделов.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект teamworkSection в тексте ответа.

Примечание.

Ответ содержит обновленное значение @odata.etag . Используйте это значение в качестве заголовка If-Match для всех последующих операций изменения.

Возможны следующие ошибки.

Код ответа Сообщение
400 Bad Request Свойство displayName является обязательным и не должно быть пустым.
400 Bad Request Значение свойства displayName не должно превышать 50 символов.
400 Bad Request Отображаемое имя раздела содержит недопустимые символы или формат.
400 Bad Request Свойства "id", "createdDateTime", "lastModifiedDateTime", "sectionType" или "isHierarchicalViewEnabled" доступны только для чтения и не должны предоставляться при создании раздела.
400 Bad Request Свойство "displayIcon.contentUrl" не поддерживается, либо свойство "displayIcon.displayName" или "displayIcon.skinTone" доступно только для чтения и не должно предоставляться.
400 Bad Request Достигнуто максимальное количество разделов.
409 Conflict Раздел с этим отображаемым именем уже существует. Возвращается, если запрошенное displayName соответствует существующему пользовательскому разделу или одному из зарезервированных системных имен разделов (RecentChats, , QuickViewsTeamsAndChannels, MutedChats, MeetingChats, EngageCommunities). Сравнение учитывает регистр.
412 Precondition Failed Значение If-Match заголовка не соответствует текущей версии иерархии разделов. Снова выведите список разделов , чтобы получить текущую заметку @microsoft.graph.sectionsVersion и повторите попытку.
428 Precondition Required Для If-Match этой операции требуется заголовок.

Примеры

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections
Content-type: application/json
If-Match: "1742515200"

{
  "displayName": "Project Alpha",
  "displayIcon": {
    "iconType": "🚀"
  },
  "sortType": "mostRecent"
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/c3d4e5f6-a7b8-9012-cdef-123456789012

{
  "@odata.type": "#microsoft.graph.teamworkSection",
  "@odata.etag": "\"1742515210\"",
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "displayName": "Project Alpha",
  "displayIcon": {
    "iconType": "🚀",
    "displayName": "Rocket",
    "contentUrl": null,
    "skinTone": null
  },
  "sectionType": "userDefined",
  "sortType": "mostRecent",
  "isExpanded": true,
  "isHierarchicalViewEnabled": false,
  "createdDateTime": "2026-03-08T10:00:00Z",
  "lastModifiedDateTime": "2026-03-08T10:00:00Z"
}