Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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"
}