Auflisten von Transkripten
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 callTranscript-Objekte ab, die einem geplanten onlineMeeting zugeordnet sind. Diese API unterstützt das Abrufen von Anruftranskripts aus privaten Chatbesprechungen und Kanalbesprechungen.
Hinweis
- Diese API unterstützt keine Besprechungen, die mit der onlineMeeting-API zum Erstellen erstellt wurden und keinem Ereignis im Kalender des Benutzers zugeordnet sind.
- Diese API gibt möglicherweise nicht alle Ergebnisse zurück, wenn mehrere Besprechungen unter einem einzelnen Kanalbeitragsthread geplant sind.
- Diese API funktioniert in einer oder mehreren nationalen Clouds anders. Weitere Informationen finden Sie unter Unterschiede bei der Implementierung der Microsoft Teams-API in nationalen Clouds.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) | OnlineMeetingTranscript.Read.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat | Nicht verfügbar. |
Anmerkung: Die Anwendungsberechtigung
OnlineMeetingTranscript.Read.Chat
verwendet die ressourcenspezifische Zustimmung. Diese Berechtigung gilt nur für geplante private Chatbesprechungen, nicht für Kanalbesprechungen.
Um Anwendungsberechtigungen für diese API zu verwenden, müssen Mandantenadministratoren eine Anwendungszugriffsrichtlinie erstellen und einem Benutzer gewähren. Es autorisiert die in der Richtlinie konfigurierte App zum Abrufen von Onlinebesprechungen oder Onlinebesprechungsartefakten im Namen dieses Benutzers (mit der im Anforderungspfad angegebenen Benutzer-ID). Weitere Informationen finden Sie unter Zulassen, dass Anwendungen im Namen eines Benutzers auf Onlinebesprechungen zugreifen können.
Hinweis
- Diese API ist für eine Besprechung verfügbar, die noch nicht abgelaufen ist. Weitere Informationen finden Sie unter Grenzwerte und Spezifikationen für Microsoft Teams.
- Diese API ist auch für Benutzer verfügbar, die Teil der Besprechungskalender-Einladung sind. Dies gilt sowohl für private Chatbesprechungen als auch für Kanalbesprechungen.
HTTP-Anforderung
GET /me/onlineMeetings/{online-meeting-id}/transcripts
GET /users/{user-id}/onlineMeetings/{online-meeting-id}/transcripts
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter von $select
, $filter
und $top
zur Anpassung der Antwort.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Auflistung von callTranscript-Objekten im Antworttext zurückgegeben.
Beispiele
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts
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#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts",
"@odata.count": 3,
"value": [
{
"id": "MSMjMCMjZDAwYWU3NjUtNmM2Yi00NjQxLTgwMWQtMTkzMmFmMjEzNzdh",
"meetingId": "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ",
"callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
"createdDateTime": "2021-09-17T06:09:24.8968037Z",
"endDateTime": "2021-09-17T06:27:25.2346000Z",
"contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
"transcriptContentUrl": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/('MSMjMCMjZDAwYWU3NjUtNmM2Yi00NjQxLTgwMWQtMTkzMmFmMjEzNzdh')/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "ba321e0d-79ee-478d-8e28-85a19507f456",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "cd6cee19-2d76-4ee0-8f47-9ed12ee44331",
}
}
},
{
"id": "MSMjMCMjMzAxNjNhYTctNWRmZi00MjM3LTg5MGQtNWJhYWZjZTZhNWYw",
"meetingId": "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ",
"callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
"createdDateTime": "2021-09-16T18:58:58.6760692Z",
"endDateTime": "2021-09-16T19:27:25.2346000Z",
"contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
"transcriptContentUrl": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/('MSMjMCMjMzAxNjNhYTctNWRmZi00MjM3LTg5MGQtNWJhYWZjZTZhNWYw')/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "ba321e0d-79ee-478d-8e28-85a19507f456",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "cd6cee19-2d76-4ee0-8f47-9ed12ee44331",
}
}
},
{
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"meetingId": "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ",
"callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
"createdDateTime": "2021-09-16T18:56:00.9038309Z",
"endDateTime": "2021-09-16T19:27:25.2346000Z",
"contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
"transcriptContentUrl": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/('MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4')/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "ba321e0d-79ee-478d-8e28-85a19507f456",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "cd6cee19-2d76-4ee0-8f47-9ed12ee44331",
}
}
}
]
}