канал: getAllMessages
Пространство имен: microsoft.graph
Извлечение сообщений из всех каналов в команде, включая текстовые, аудио и видео сообщения.
Дополнительные сведения об использовании API экспорта Microsoft Teams для экспорта содержимого см. в статье Экспорт содержимого с помощью API экспорта Microsoft Teams.
Примечание: Это лимитный API, который поддерживает
model=A
модели оплаты иmodel=B
. Дополнительные сведения см. в разделе Модели оплаты. Если в запросе не указана модель оплаты, будет использоваться режим оценки по умолчанию.В зависимости от выбранной модели оплаты также может потребоваться лицензия.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Не поддерживается. | Не поддерживается. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | ChannelMessage.Read.All | Недоступно. |
HTTP-запрос
GET /teams/{team-id}/channels/getAllMessages
Необязательные параметры запроса
Вы можете использовать параметр запроса model
, который поддерживает значения A
и B
, в зависимости от предпочитаемой модели лицензирования и оплаты, как показано в следующих примерах.
Если параметр model
не указан, будет использоваться режим оценки.
GET /teams/{team-id}/channels/getAllMessages?model=A
GET /teams/{team-id}/channels/getAllMessages?model=B
Если параметр model
не указан, будет использоваться режим оценки.
Вы можете использовать параметр запроса $top для управления количеством элементов в одном отклике. Кроме того, $filter поддерживается в запросе диапазона dateTime ресурса lastModifiedDateTime. Другие параметры запроса OData в настоящее время не поддерживаются.
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {код}. Обязательно. |
Текст запроса
Не указывайте текст запроса для этого метода.
Ответ
В случае успешного выполнения этот метод возвращает код отклика 200 OK
, а также все сообщения в общедоступных и закрытых каналах.
Пример
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/teams/01fe12e0-e720-44fd-8854-28c66d1bee40/channels/getAllMessages?$filter=lastModifiedDateTime+gt+2019-11-01T00:00:00Z+and lastModifiedDateTime+lt+2021-11-01T00:00:00Z
Отклик
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(chatMessage)",
"@odata.count": 2,
"@odata.nextLink": "https://graph.microsoft.com/v1.0/teams('01fe12e0-e720-44fd-8854-28c66d1bee40')/channels/getallMessages?$skiptoken=U2tpcFZhbHVlPTAjUHJpdmF0ZUNoYW5uZWxJZD0xOTpmYWU5YTJmZjk1ZGE0ZTEwOWE1YTg3ZTM5Y2FkOGYyYkB0aHJlYWQudGFjdjIjVXNlcklkPTBkN2M2M2QzLTEzMDYtNGVlYy04ZjIxLTU4OGE3MGZiNmVmMSNNYWlsYm94Rm9sZGVyPU1haWxGb2xkZXJzL1RlYW1DaGF0&$filter=lastModifiedDateTime+gt+2019-11-01T00%3a00%3a00Z+and+lastModifiedDateTime+lt+2021-11-01T00%3a00%3a00Z",
"value": [
{
"@odata.type": "#microsoft.graph.chatMessage",
"id": "1622071758431",
"replyToId": "1622071642456",
"etag": "1622071758431",
"messageType": "message",
"createdDateTime": "2021-05-26T23:29:18.431Z",
"lastModifiedDateTime": "2021-05-26T23:29:18.431Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3Afae9a2ff95da4e109a5a87e39cad8f2b%40thread.tacv2/1622071758431?groupId=01fe12e0-e720-44fd-8854-28c66d1bee40&tenantId=9854dc85-3fb3-4f8e-a055-9cdc5523024d&createdTime=1622071758431&parentMessageId=1622071642456",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"id": "0b4f1cf6-54c8-4820-bbb7-2a1f4257ade5",
"displayName": "user1 a",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "html",
"content": "<div>\n<div itemprop=\"copy-paste-block\">reply 9 to new conv</div>\n</div>"
},
"channelIdentity": {
"teamId": "01fe12e0-e720-44fd-8854-28c66d1bee40",
"channelId": "19:fae9a2ff95da4e109a5a87e39cad8f2b@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
},
{
"@odata.type": "#microsoft.graph.chatMessage",
"id": "1622071764529",
"replyToId": "1622071642456",
"etag": "1622071764529",
"messageType": "message",
"createdDateTime": "2021-05-26T23:29:24.529Z",
"lastModifiedDateTime": "2021-05-26T23:29:24.529Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3Afae9a2ff95da4e109a5a87e39cad8f2b%40thread.tacv2/1622071764529?groupId=01fe12e0-e720-44fd-8854-28c66d1bee40&tenantId=9854dc85-3fb3-4f8e-a055-9cdc5523024d&createdTime=1622071764529&parentMessageId=1622071642456",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"id": "0b4f1cf6-54c8-4820-bbb7-2a1f4257ade5",
"displayName": "user1 a",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "html",
"content": "<div>\n<div itemprop=\"copy-paste-block\">reply 10 to new conv</div>\n</div>"
},
"channelIdentity": {
"teamId": "01fe12e0-e720-44fd-8854-28c66d1bee40",
"channelId": "19:fae9a2ff95da4e109a5a87e39cad8f2b@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
}
]
}
Связанные материалы
Ограничения регулирования для служб, связанных с Microsoft Graph