Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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/{teamworkSection-id}/items/{teamworkSectionItem-id}/move
Заголовки запросов
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
| If-Match | Значение заметки @microsoft.graph.sectionsVersion , возвращаемой при перечислении разделов, или значение @odata.etag из любого ранее полученного раздела. Требуется для управления оптимистическим параллелизмом. |
Текст запроса
В тексте запроса укажите представление параметров в формате JSON.
В следующей таблице перечислены параметры, необходимые при вызове этого действия.
| Параметр | Тип | Описание |
|---|---|---|
| targetSectionId | String | Идентификатор раздела, в который перемещается элемент. Обязательно. |
Отклик
В случае успешного 200 OK выполнения это действие возвращает код ответа и teamworkSectionItem в тексте ответа, представляющего элемент в целевом разделе.
Примечание.
Ответ содержит обновленное значение @odata.etag . Используйте это значение в качестве заголовка If-Match для всех последующих операций изменения.
Возможны следующие ошибки.
| Код ответа | Сообщение |
|---|---|
400 Bad Request |
Свойство targetSectionId является обязательным и не должно быть пустым. |
400 Bad Request |
Исходный и целевой разделы должны отличаться. |
403 Forbidden |
Этот раздел создан системой и не может быть изменен. С помощью этого действия элементы не могут быть перемещены в определенные системой разделы или из него. |
404 Not Found |
Указанный раздел не найден или указанный элемент не найден в этом разделе. |
412 Precondition Failed |
Значение If-Match заголовка не соответствует текущей версии иерархии разделов.
Снова выведите список разделов , чтобы получить текущую заметку @microsoft.graph.sectionsVersion и повторите попытку. |
428 Precondition Required |
Для If-Match этой операции требуется заголовок. |
Примеры
Запрос
В следующем примере показан запрос на перемещение чата из раздела "Избранное" в раздел "Project Alpha".
POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2/move
Content-type: application/json
If-Match: "1742515200"
{
"targetSectionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.type": "#microsoft.graph.teamworkSectionItem",
"@odata.etag": "\"1742515210\"",
"id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
"itemType": "chat",
"createdDateTime": "2026-03-08T10:30:00Z",
"lastModifiedDateTime": null
}