chatMessage: delta
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Ruft die Liste der Nachrichten (ohne die Antworten) in einem Kanal eines Teams ab. Mithilfe von delta-Abfrage können Sie neue oder aktualisierte Nachrichten in einem Kanal abrufen.
Hinweis: Delta gibt nur Nachrichten innerhalb der letzten acht Monate zurück. Sie können GET /teams/{team-id}/channels/{channel-id}/messages verwenden, um ältere Nachrichten abzurufen.
Die delta-Abfrage unterstützt die vollständige Synchronisierung, die alle Nachrichten im angegebenen Kanal abruft, und die inkrementelle Synchronisierung, die nur die Nachrichten abruft, die seit der letzten Synchronisierung im Kanal hinzugefügt oder geändert wurden. In der Regel führen Sie zunächst eine vollständige Synchronisierung durch und rufen dann regelmäßig inkrementelle Änderungen an dieser Nachrichtenansicht ab.
Um die Antworten für eine Nachricht abzurufen, verwenden Sie den Vorgang zum Auflisten der Nachrichtenantworten oder den Vorgang zum Abrufen der Nachrichtenantwort.
Eine GET-Anforderung mit der delta-Funktion gibt Folgendes zurück:
- Ein
@odata.nextLink
-Objekt, das eine URL mit einem delta-Funktionsaufruf und einemskipToken
-Objekt enthält, oder - Ein
@odata.deltaLink
-Objekt, das eine URL mit einem delta-Funktionsaufruf und einemdeltaToken
-Objekt enthält.
Zustandstoken sind für den Client nicht transparent. Um mit einer Runde der Änderungsnachverfolgung fortzufahren, kopieren Sie die von der @odata.nextLink
letzten GET-Anforderung zurückgegebene URL oder @odata.deltaLink
auf den nächsten Delta-Funktionsaufruf für dieselbe Kalenderansicht, und wenden Sie sie an. @odata.deltaLink
(in einer Antwort zurückgegeben), bedeutet, dass die aktuelle Runde der Änderungsnachverfolgung abgeschlossen ist. Sie können die @odata.deltaLink
-URL speichern und verwenden, wenn Sie damit beginnen, zusätzliche Änderungen abzurufen (Nachrichten, die nach dem Erwerb von @odata.deltaLink
geändert oder veröffentlicht wurden).
Weitere Informationen hierzu finden Sie in der Dokumentation zur delta-Abfrage.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | ChannelMessage.Read.All | Group.Read.All, Group.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | ChannelMessage.Read.Group | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All |
Hinweis
- Die Berechtigung ChannelMessage.Read.Group verwendet ressourcenspezifische Zustimmung.
- Die Berechtigungen Group.Read.All und Group.ReadWrite.All werden nur aus Gründen der Abwärtskompatibilität unterstützt. Es wird empfohlen, Ihre Lösungen zu aktualisieren, sodass sie eine alternative Berechtigung verwenden, die in der vorherigen Tabelle aufgeführt ist, und diese Berechtigungen in Zukunft nicht mehr verwenden.
HTTP-Anforderung
GET /teams/{team-id}/channels/{channel-id}/messages/delta
Abfrageparameter
Beim Nachverfolgen von Änderungen in Kanalnachrichten wird eine Runde von einem oder mehreren delta-Funktionsaufrufen ausgeführt. Wenn Sie Abfrageparameter (außer $deltatoken
und $skiptoken
) verwenden, müssen Sie sie in der ursprünglichen Delta-Anforderung angeben. Microsoft Graph codiert automatisch alle angegebenen Parameter in den Tokenteil der in der Antwort enthaltenen @odata.nextLink
- oder @odata.deltaLink
-URL.
Sie müssen alle Abfrageparameter nur einmal im Vorfeld angeben.
In nachfolgenden Anforderungen können Sie die @odata.nextLink
- oder @odata.deltaLink
-URL aus der vorherigen Antwort kopieren und anwenden, da diese URL bereits die codierten Parameter enthält.
Abfrageparameter | Typ | Beschreibung |
---|---|---|
$deltatoken |
string | Ein Zustandstoken, das in der @odata.deltaLink -URL des vorhergehenden delta-Funktionsaufrufs zurückgegeben wird und den Abschluss dieser Runde der Änderungsnachverfolgung anzeigt. Speichern Sie die gesamte @odata.deltaLink -URL einschließlich dieses Tokens, und wenden Sie diese in der ersten Anforderung der nächsten Iteration der Änderungsnachverfolgung für diese Sammlung an. |
$skiptoken |
string | Ein Zustandstoken, das in der @odata.nextLink -URL des vorhergehenden delta-Funktionsaufrufs zurückgegeben wird und anzeigt, dass weitere Änderungen zum Nachverfolgen vorliegen. |
Optionale OData-Abfrageparameter
Die folgenden OData-Abfrageparameter werden von dieser API unterstützt:
$top
stellt die maximale Anzahl von Nachrichten dar, die in einem Aufruf abgerufen werden sollen. Die Obergrenze beträgt 50.$skip
gibt an, wie viele Nachrichten am Anfang der Liste übersprungen werden sollen.$filter
ermöglicht das Zurückgeben von Nachrichten, die bestimmten Kriterien entsprechen. Die einzige Eigenschaft, die das Filtern unterstützt, istlastModifiedDateTime
, und nur der Operator gt wird unterstützt. Ruft../messages/delta?$filter=lastModifiedDateTime gt 2019-02-27T07:13:28.000z
beispielsweise jede Antwortkette (jede Kanalpostnachricht und zugehörige Antwortnachrichten) ab, die nach der angegebenen Datumszeit erstellt oder geändert wurden.$expand
ermöglicht das Erweitern von Eigenschaften für jede Kanalnachricht. Es werden nur Antworten unterstützt. Wenn eine Kanalnachricht mehr als 1000 Antworten enthält,replies@odata.nextLink
wird für die Paginierung bereitgestellt.
Hinweis: Informationen
$expand
zum Abfrageparameter finden Sie unter "Nachrichten des Listenkanals".
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und eine Sammlung von chatMessage-Objekten im Antworttext zurückgegeben. Die Antwort enthält auch eine @odata.nextLink
-URL oder eine @odata.deltaLink
-URL.
Beispiele
Beispiel 1: Erstsynchronisierung
Das folgende Beispiel zeigt eine Reihe von drei Anforderungen zum Synchronisieren der Nachrichten im angegebenen Kanal. Der Kanal enthält fünf Nachrichten.
- Schritt 1: ursprüngliche Anforderung und Antwort.
- Schritt 2: zweite Anforderung und Antwort
- Schritt 3: dritte Anforderung und letzte Antwort.
Aus Platzgründen wird in den Beispielantworten nur eine Untergruppe der Eigenschaften eines Ereignisses angezeigt. In einem tatsächlichen Aufruf werden die meiste Ereigniseigenschaften zurückgegeben.
Erfahren Sie auch, was Sie tun können , um zusätzliche Änderungen abzurufen.
Ursprüngliche Anforderung
In diesem Beispiel werden die Kanalnachrichten zum ersten Mal synchronisiert, sodass die anfängliche Synchronisierungsanforderung kein Zustandstoken enthält und alle Ereignisse in dieser Kalenderansicht zurückgibt.
Die Anforderung gibt den optionalen Anforderungsheader odata.top an, der gleichzeitig zwei Ereignisse zurückgibt.
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$top=2
Antwort auf die ursprüngliche Anforderung
Die Antwort enthält zwei Nachrichten und einen @odata.nextLink
-Antwortheader mit einem skipToken
. Die @odata.nextLink
-URL zeigt an, dass weitere abzurufende Nachrichten im Kanal vorhanden sind.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
"@odata.nextLink": "https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$skiptoken=-FG3FPHv7HuyuazNLuy3eXlzQGbEjYLUsW9-pYkmXgn5KGsaOwrCoor2W23dGNNM1KtAX4AyvpFQNVsBgsEwUOX9lw8x9zDumgJy-C-UbjZLlZDQACyC9FyrVelZus9n.--rshdLwy_WBFJd8anPXJPbSUtUD7r3V4neB5tcrG58",
"value": [
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1606515483514",
"messageType": "message",
"createdDateTime": "2020-11-27T22:18:03.514Z",
"lastModifiedDateTime": "2020-11-27T22:18:03.514Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1606515483514?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1606515483514&parentMessageId=1606515483514",
"policyViolation": null,
"eventDetail": null,
"id": "1606515483514",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "Test"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": [],
"messageHistory": []
},
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1606691795113",
"messageType": "message",
"createdDateTime": "2020-11-29T23:16:35.113Z",
"lastModifiedDateTime": "2020-11-29T23:16:35.113Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1606691795113?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1606691795113&parentMessageId=1606691795113",
"policyViolation": null,
"eventDetail": null,
"id": "1606691795113",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "HelloWorld 11/29/2020 3:16:31 PM -08:00"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": [],
"messageHistory": []
}
]
}
Zweite Anforderung
Die zweite Anforderung gibt die aus der vorherigen Antwort zurückgegebene @odata.nextLink
-URL an. Beachten Sie, dass sie nicht dieselben Top-Parameter wie in der ursprünglichen Anforderung angeben muss, da skipToken
in der @odata.nextLink
-URL diese codiert und einschließt.
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$skiptoken=-FG3FPHv7HuyuazNLuy3eXlzQGbEjYLUsW9-pYkmXgn5KGsaOwrCoor2W23dGNNM1KtAX4AyvpFQNVsBgsEwUOX9lw8x9zDumgJy-C-UbjZLlZDQACyC9FyrVelZus9n.--rshdLwy_WBFJd8anPXJPbSUtUD7r3V4neB5tcrG58
Antwort auf die zweite Anforderung
Die zweite Antwort gibt die nächsten beiden Nachrichten zurück, und ein @odata.nextLink
Antwortheader mit einem skipToken
gibt an, dass weitere Nachrichten im Kanal abgerufen werden sollen.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
"@odata.nextLink": "https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$skiptoken=8UusBixEHS9UUau6uGcryrA6FpnWwMJbuTYILM1PArHxnZzDVcsHQrijNzCyIVeEauMQsKUfMhNjLWFs1o4sBS_LofJ7xMftZUfec_pijuT6cAk5ugcWCca9RCjK7iVj.DKZ9w4bX9vCR7Sj9P0_qxjLAAPiEZgxlOxxmCLMzHJ4",
"value": [
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1606691812117",
"messageType": "message",
"createdDateTime": "2020-11-29T23:16:52.117Z",
"lastModifiedDateTime": "2020-11-29T23:16:52.117Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1606691812117?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1606691812117&parentMessageId=1606691812117",
"policyViolation": null,
"id": "1606691812117",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "HelloWorld 11/29/2020 3:16:51 PM -08:00"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": []
},
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1606691846203",
"messageType": "message",
"createdDateTime": "2020-11-29T23:17:26.203Z",
"lastModifiedDateTime": "2020-11-29T23:17:26.203Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1606691846203?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1606691846203&parentMessageId=1606691846203",
"policyViolation": null,
"id": "1606691846203",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "HelloWorld 11/29/2020 3:17:25 PM -08:00"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": [],
"messageHistory": []
}
]
}
Dritte Anforderung
Die dritte Anforderung verwendet weiterhin das neueste aus der letzten Synchronisierungsanforderung zurückgegebene @odata.nextLink
.
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$skiptoken=8UusBixEHS9UUau6uGcryrA6FpnWwMJbuTYILM1PArHxnZzDVcsHQrijNzCyIVeEauMQsKUfMhNjLWFs1o4sBS_LofJ7xMftZUfec_pijuT6cAk5ugcWCca9RCjK7iVj.DKZ9w4bX9vCR7Sj9P0_qxjLAAPiEZgxlOxxmCLMzHJ4
Antwort auf die dritte Anforderung
Die dritte Antwort gibt die verbleibenden Nachrichten im Kanal sowie einen @odata.deltaLink
-Antwortheader mit einem deltaToken
zurück, der anzeigt, dass alle Nachrichten im Kanal gelesen wurden. Speichern Sie die @odata.deltaLink
-URL, und verwenden Sie diese, um von diesem Punkt aus neue Nachrichten abzufragen.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$deltatoken=aQdvS1VwGCSRxVmZJqykmDik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4",
"value": [
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1611351582080",
"messageType": "message",
"createdDateTime": "2021-01-22T21:39:42.08Z",
"lastModifiedDateTime": "2021-01-22T21:39:42.08Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1611351582080?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1611351582080&parentMessageId=1611351582080",
"policyViolation": null,
"id": "1611351582080",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "HelloWorld 1/22/2021 1:39:39 PM -08:00"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": []
},
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1611351603178",
"messageType": "message",
"createdDateTime": "2021-01-22T21:40:03.178Z",
"lastModifiedDateTime": "2021-01-22T21:40:03.178Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1611351603178?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1611351603178&parentMessageId=1611351603178",
"policyViolation": null,
"id": "1611351603178",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "HelloWorld 1/22/2021 1:40:00 PM -08:00"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": [],
"messageHistory": []
}
]
}
Beispiel 2: Abrufen weiterer Änderungen
Wenn Sie die @odata.deltaLink
aus der letzten Anforderung in der letzten Runde verwenden, erhalten Sie nur die Nachrichten, die sich in diesem Kanal seitdem geändert haben (durch Hinzufügen oder Aktualisieren). Ihre Anforderung sieht wie folgt aus, vorausgesetzt, Sie bevorzugen es, die gleiche maximale Seitengröße in der Antwort beizubehalten:
Anforderung
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$deltatoken=aQdvS1VwGCSRxVmZJqykmDik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/delta?$deltatoken=aQdvS1VwGCSRxVmZJqykmDik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_yjz2nsMoh1gXNtXii7s78HapCi5woifXqwXlVNxICh8wUUnvE2gExsa8eZ2Vy_ch5rVIhm067_1mUPML3iYUVyg.3o0rhgaBUduuxOr98An5pjBDP5JjKUiVWku3flSiOsk",
"value": [
{
"@odata.type": "#microsoft.graph.chatMessage",
"replyToId": null,
"etag": "1616989510408",
"messageType": "message",
"createdDateTime": "2021-03-29T03:45:10.408Z",
"lastModifiedDateTime": "2021-03-29T03:45:10.408Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616989510408?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616989510408&parentMessageId=1616989510408",
"policyViolation": null,
"id": "1616989510408",
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
"displayName": "Robin Kline",
"userIdentityType": "aadUser",
"tenantId": "e61ef81e-8bd8-476a-92e8-4a62f8426fca"
}
},
"body": {
"contentType": "text",
"content": "Hello World 28th March 2021"
},
"channelIdentity": {
"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
},
"onBehalfOf": null,
"attachments": [],
"mentions": [],
"reactions": [],
"messageHistory": []
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für