channel: getAllMessages
名前空間: microsoft.graph
テキスト、オーディオ、ビデオの会話など、チーム内のすべてのチャネルのメッセージを取得します。
Microsoft Teams エクスポート API を使用してコンテンツをエクスポートする方法の詳細については、「Microsoft Teams エクスポート API でコンテンツをエクスポートする」を参照してください。
メモ:これは、 と
model=B
支払いモデルをサポートするmodel=A
従量制課金 API です。 詳細については、「 支払いモデル」を参照してください。 クエリで支払いモデルを指定しない場合は、既定の 評価モード が使用されます。選択した支払いモデルによっては、ライセンスも必要になる場合があります。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | サポートされていません。 | サポートされていません。 |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | 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 は lastModifiedDateTime の dateTime クエリでサポートされています。 その他の OData クエリ パラメーターは現在サポートされていません。
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {code}。 必須です。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 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": []
}
]
}