userTeamwork: deleteTargetedMessage

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

Удаление определенного целевого сообщения из контекста канала. Администраторы Teams могут использовать этот API для удаления целевых сообщений, указав идентификатор сообщения, идентификатор команды и идентификатор канала.

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

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

Разрешения

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

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

HTTP-запрос

POST /users/{user-id | userPrincipalName}/teamwork/deleteTargetedMessage

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type application/json. Обязательно.

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

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

В следующей таблице перечислены параметры, которые необходимы при вызове этого действия.

Параметр Тип Описание
channelId String Уникальный идентификатор канала, на который было отправлено целевое сообщение. Обязательно.
messageId String Уникальный идентификатор целевого сообщения для удаления. Этот идентификатор уникален в контексте указанного канала и пользователя. Обязательно.
teamID String Уникальный идентификатор группы, содержащий канал, в котором было отправлено целевое сообщение. Обязательно.

Отклик

В случае успешного выполнения это действие возвращает код отклика 204 No Content.

Примеры

Запрос

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

POST https://graph.microsoft.com/v1.0/users/f47b5f54-6968-4706-a522-31e842b12345/teamwork/deleteTargetedMessage
Content-Type: application/json

{
  "teamId": "9dda0ae1-e007-4a1d-81ec-2cf4b1274610",
  "channelId": "19:eeaa4e946d674c4f8d4dded613780f45@thread.v2",
  "messageId": "1580849738240"
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content
  • Last updated on