Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Rufen Sie ein callTranscript-Objekt ab, das einem geplanten onlineMeeting und einem Ad-hoc-Aufruf zugeordnet ist. Diese API unterstützt das Abrufen von Anruftranskripts aus privaten Chatbesprechungen und Kanalbesprechungen sowie Ad-hoc-Anrufe, einschließlich PSTN, 1:1 und Gruppenanrufen. Private Kanalbesprechungen werden nicht unterstützt.
Beim Abrufen des Transkripts werden die Metadaten des einzelnen Transkripts zurückgegeben, das einer Onlinebesprechung oder einem Ad-hoc-Anruf zugeordnet ist. Beim Abrufen des Inhalts des Transkripts wird der dem Transkript zugeordnete Textstrom zurückgegeben.
Hinweis
Für Onlinebesprechungen:
- Dies ist eine getaktete API. Weitere Informationen finden Sie unter Zahlungsmodelle für Besprechungs-APIs.
- 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 kein Anruftranskript 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 Implementierungsunterschiede in nationalen Clouds.
- Wenn Sie Besprechungstranskripte abrufen möchten, verwenden Sie stattdessen die Ereigniserstellungs-API .
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 (für Onlinebesprechungen) CallTranscripts.Read.All (für Ad-hoc-Anrufe) | Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat (für Onlinebesprechungen) CallTranscripts.Read.All (für Ad-hoc-Anrufe) | Nicht verfügbar. |
Hinweis
Die Anwendungsberechtigungen OnlineMeetingTranscript.Read.Chat verwenden ressourcenspezifische Zustimmung. Die OnlineMeetingTranscript.Read.Chat 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 und/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
Für Onlinebesprechungen:
- 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.
Mandantenadministratorsteuerungen für den Transkriptzugriff
Der Zugriff auf Transkripte über diese API erfordert die entsprechenden Graph-Berechtigungen und wird auch von zwei unabhängigen Mandantenadministratoreinstellungen gesteuert:
Graph-API Zugriff auf Transkripte. Wenn diese Option deaktiviert ist, werden alle Transkriptanforderungen (Metadaten,
metadataContentundcontent) unabhängig vom angeforderten Format mit demGraphAccessToTranscriptsDisabledinneren Fehlercode zurückgegeben403 Forbidden.Sprecherzuordnung. Wenn diese Option deaktiviert ist, können Transkriptinhalte nur ohne Sprecherinformationen abgerufen werden.
Ein Mandantenadministrator konfiguriert diese Besprechungseinstellungen im Teams Admin Center oder mithilfe des Set-CsTeamsMeetingConfiguration Cmdlets.
Der /content Endpunkt unterstützt zwei Formate:
-
text/vtt(Standard) – WebVTT mit zeitstempelten Äußerungen und<v Speaker>Sprachtags (sprecherseitig attributiert). -
application/vnd.microsoft.graph.transcript+text— Äußerungen mit Zeitstempel ohne Sprecherinformationen (Sprecher ohne Attribut).
Wählen Sie text/vtt entweder mit dem Accept Header oder dem $format Abfrageparameter aus. Das application/vnd.microsoft.graph.transcript+text Format muss mit dem Accept Header ausgewählt werden. Es wird nicht über den $format Abfrageparameter unterstützt.
Wenn der Mandantenadministrator die Sprecherzuordnung deaktiviert hat, wird die Anforderung des attributierten Formats (text/vtt) mit dem SpeakerAttributionNotAllowed inneren Fehlercode zurückgegeben403 Forbidden. Wiederholen Sie den Vorgang mit dem nicht attributierten Format, um das Transkript abzurufen. Die Einstellung für die Sprecherzuordnung blockiert nie das nicht attributierte Format, es unterliegt jedoch der Einstellung Graph-API Zugriff auf Transkripte.
Hinweis
Das application/vnd.microsoft.graph.transcript+text Format und die zugehörigen Mandantenadministratorsteuerelemente werden Ende Juli 2026 wirksam.
HTTP-Anforderung
Wählen Sie auf den /content Endpunkten das Transkriptinhaltsformat mit dem Accept Anforderungsheader aus, wie unter Transkriptinhaltsformate beschrieben.
Abrufen eines einzelnen Transkripts für eine Onlinebesprechung
GET /me/onlineMeetings/{meetingId}/transcripts/{transcriptId}
GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}
Abrufen des Inhalts eines einzelnen Transkripts für eine Onlinebesprechung
- Sowohl Transkription als auch Sprecherzuordnung sind aktiviert.
GET /me/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
- Die Transkription ist aktiviert, aber die Sprecherzuordnung ist deaktiviert.
GET /me/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
Abrufen eines einzelnen Transkripts für einen Ad-hoc-Aufruf
GET /me/adhocCalls/{callId}/transcripts/{transcriptId}
GET /users/{userId}/adhocCalls/{callId}/transcripts/{transcriptId}
Abrufen des Inhalts eines einzelnen Transkripts für einen Ad-hoc-Aufruf
- Sowohl Transkription als auch Sprecherzuordnung sind aktiviert.
GET /me/adhocCalls/{callId}/transcripts/{transcriptId}/content
GET /users/{userId}/adhocCalls/{callId}/transcripts/{transcriptId}/content
- Die Transkription ist aktiviert, aber die Sprecherzuordnung ist deaktiviert.
GET /me/adhocCalls/{callId}/transcripts/{transcriptId}/content
GET /users/{userId}/adhocCalls/{callId}/transcripts/{transcriptId}/content
Optionale Abfrageparameter
Diese Methode unterstützt den $selectOData-Abfrageparameter , um die Antwort anzupassen.
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Accept |
text/vtt oder application/vnd.microsoft.graph.transcript+text. Optional. Wählt auf den /content Endpunkten das Transkriptinhaltsformat aus. Für text/vttentspricht dies dem $format Abfrageparameter. Das application/vnd.microsoft.graph.transcript+text Format wird nur über diesen Header unterstützt. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein callTranscript-Objekt im Antworttext zurück.
Transkriptinhaltsformate
Der /content Endpunkt unterstützt die folgenden Formate. Wählen Sie text/vtt entweder den $format Abfrageparameter oder den Anforderungsheader Accept aus. Das application/vnd.microsoft.graph.transcript+text Format muss mit dem Anforderungsheader Accept ausgewählt werden.
| Format | Sprecherzuordnung | Beschreibung |
|---|---|---|
text/vtt |
Ja | WebVTT mit Zeitstempeläußerungen und <v Speaker> Sprachtags. Wird standardmäßig zurückgegeben. |
application/vnd.microsoft.graph.transcript+text |
Nein | Nur Mit Zeitstempel versehene Äußerungen, ohne <v Speaker> Sprachtags. |
Wenn der Mandant die Sprecherzuordnung verbietet, schlagen Anforderungen für text/vtt stattdessen mitSpeakerAttributionNotAllowed403 Forbidden / fehl.application/vnd.microsoft.graph.transcript+text
Fehlerantworten
Diese API wird durch Mandantenadministratoreinstellungen für den Transkriptzugriff und die Sprecherzuordnung gesteuert. Branch für den innerError.code Wert, nicht für den Meldungstext. Nachrichten können geändert werden.
Graph-API Zugriff auf Transkripte ist deaktiviert
Wenn ein Mandantenadministrator Graph-API Zugriff auf Transkripte für den Mandanten deaktiviert hat, werden alle Transkriptanforderungen – Metadaten, metadataContentund content – mit dem GraphAccessToTranscriptsDisabled inneren Fehlercode zurückgegeben403 Forbidden. Es gibt keine anforderungsseitige Problemumgehung. Die App empfängt diese Antwort, bis ein Administrator den Zugriff wieder aktiviert.
HTTP/1.1 403 Forbidden
Content-Type: application/json
{
"error": {
"code": "Forbidden",
"message": "Graph API access to transcripts is disabled for this tenant.",
"innerError": {
"code": "GraphAccessToTranscriptsDisabled"
}
}
}
Vom Sprecher zugewiesene Inhalte sind deaktiviert.
Wenn ein Mandantenadministrator die Sprecherzuordnung nicht zugibt, geben die Endpunkte nur dann mit dem SpeakerAttributionNotAllowed inneren Fehlercode zurück 403 Forbidden, wenn die Anforderung ein sprecherseitig zugewiesenes Format (text/vtt) anfragt./content Wiederholen Sie dieselbe Anforderung, indem Sie das nicht attributierte Format anfordern, application/vnd.microsoft.graph.transcript+textdas erfolgreich ist. Dieser Fehler gilt nur für die /content Endpunkte (pro Besprechung und Ad-hoc). Transkriptmetadatenanforderungen sind nicht betroffen.
HTTP/1.1 403 Forbidden
Content-Type: application/json
{
"error": {
"code": "Forbidden",
"message": "Speaker-attributed transcript content is disabled for this tenant. Retry with Accept 'application/vnd.microsoft.graph.transcript+text'.",
"innerError": {
"code": "SpeakerAttributionNotAllowed"
}
}
}
Beispiele
Hinweis
Das docx-Format für Transkripte ist ab dem 31. Mai 2023 veraltet.
Beispiel 1: Abrufen eines Anruftranskripts für Onlinebesprechungen
Das folgende Beispiel zeigt, wie Sie ein einzelnes Transkript einer Onlinebesprechung abrufen.
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4
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/$entity",
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"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/('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",
}
}
}
Beispiel 2: Abrufen eines Anruftranskripts für Ad-hoc-Anruf
Das folgende Beispiel zeigt, wie Sie ein einzelnes Transkript eines Ad-hoc-Aufrufs abrufen.
Anforderung
GET https://graph.microsoft.com/beta/users/f2e8e111-3887-4936-87f8-639292c70d34/adhocCalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=
Antwort
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('f2e8e111-3887-4936-87f8-639292c70d34')/adhocCalls('5f3640e7-a59c-4bec-82ca-e66251f795b7')/transcripts/$entity",
"id": "MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=",
"callId": "5f3640e7-a59c-4bec-82ca-e66251f795b7",
"createdDateTime": "2025-08-11T06:03:42.9757215Z",
"endDateTime": "2025-08-11T06:04:21.2551933Z",
"contentCorrelationId": "c316fb26-aed9-4476-8827-b5be74f74051-10002",
"transcriptContentUrl": "https://graph.microsoft.com/beta/users/f2e8e111-3887-4936-87f8-639292c70d34/adhocCalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts('MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=')/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "f2e8e111-3887-4936-87f8-639292c70d34",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "8393309d-9fb7-4cce-aafb-eedc8c5781e2"
}
}
}
Beispiel 3: Abrufen eines callTranscript-Inhalts für eine Onlinebesprechung, bei der sprecheratmierte Inhalte aktiviert sind
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Antwort
Die Antwort enthält Bytes für das Transkript im Text.
content-type header gibt den Typ des Transkriptinhalts an. Negative Offsets deuten darauf hin, dass die Transkription begonnen hat, während die Konversation fortgesetzt wurde.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Beispiel 4: Abrufen eines callTranscript-Inhalts für einen Ad-hoc-Anruf, wenn sprecheratmierte Inhalte deaktiviert sind
Anforderung
GET https://graph.microsoft.com/beta/users/f2e8e111-3887-4936-87f8-639292c70d34/adhocCalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=/content
Accept: application/vnd.microsoft.graph.transcript+text
Antwort
Die Antwort enthält das Transkript im Text als Bytes. Der content-type Header gibt den Typ des Transkriptinhalts an. Negative Offsets deuten darauf hin, dass die Transkription begonnen hat, während die Konversation fortgesetzt wurde.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: application/vnd.microsoft.graph.transcript+text
00:00:01.500 --> 00:00:04.000
Hello, thanks for joining.
00:00:04.000 --> 00:00:07.200
Glad to be here.
Beispiel 5: Abrufen eines callTranscript-Inhalts für eine Onlinebesprechung, wenn sprecherseitig zugewiesene Inhalte deaktiviert sind
Das folgende Beispiel zeigt, wie Sie den Inhalt eines einzelnen Transkripts einer Onlinebesprechung abrufen, wenn sprecherseitig zugewiesene Inhalte deaktiviert sind.
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.microsoft.graph.transcript+text
Antwort
Die Antwort enthält den Transkriptinhalt im Text als Bytes. Der content-type Header gibt den Typ des Transkriptinhalts an. Negative Offsets deuten darauf hin, dass die Transkription begonnen hat, während die Konversation fortgesetzt wurde.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: application/vnd.microsoft.graph.transcript+text
00:00:01.500 --> 00:00:04.000
Hello, thanks for joining.
00:00:04.000 --> 00:00:07.200
Glad to be here.
Beispiel 6: Abrufen von nicht attributiertem callTranscript-Inhalt
Das folgende Beispiel zeigt, wie Transkriptinhalte ohne Sprecherzuordnung abgerufen werden. Fordern Sie dieses Format mithilfe des Headers Accept an.
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.microsoft.graph.transcript+text
Antwort
Die Antwort enthält den Transkriptinhalt im Text als Bytes ohne <v Speaker> Sprachtags. Der Content-type-Header gibt den Typ des Transkriptinhalts an.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: application/vnd.microsoft.graph.transcript+text
00:00:16.246 --> 00:00:17.726
This is a transcript test.
Beispiel 7: Sprecherzuordnung durch Mandantenrichtlinie deaktiviert
Das folgende Beispiel zeigt die Antwort, wenn die Sprecherzuordnung für den Mandanten deaktiviert ist und die Anforderung ein attributiertes Format (text/vtt) anfragt. Wiederholen Sie den Vorgang mit application/vnd.microsoft.graph.transcript+text , um das nicht attributierte Transkript zu erhalten.
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: text/vtt
Antwort
HTTP/1.1 403 Forbidden
Content-Type: application/json
{
"error": {
"code": "Forbidden",
"message": "Speaker-attributed transcript content is disabled for this tenant. Retry with Accept 'application/vnd.microsoft.graph.transcript+text'.",
"innerError": {
"code": "SpeakerAttributionNotAllowed"
}
}
}
Beispiel 8: Abrufen eines callTranscript-Inhalts für einen Ad-hoc-Anruf, wenn sprecheratmierte Inhalte aktiviert sind
Das folgende Beispiel zeigt, wie Sie den Inhalt eines einzelnen Transkripts eines Ad-hoc-Anrufs abrufen, wenn sprecheratmierte Inhalte aktiviert sind.
Anforderung
GET https://graph.microsoft.com/beta/users/f2e8e111-3887-4936-87f8-639292c70d34/adhocCalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=/content
Accept: text/vtt
Antwort
Die Antwort enthält das Transkript im Text als Bytes. Der content-type Header gibt den Typ des Transkriptinhalts an. Negative Offsets deuten darauf hin, dass die Transkription begonnen hat, während die Konversation fortgesetzt wurde.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
00:00:01.500 --> 00:00:04.000
<v User Name>Hello, thanks for joining.</v>
00:00:04.000 --> 00:00:07.200
<v User Name>Glad to be here.</v>
Beispiel 9: Abrufen von callTranscript metadataContent für Onlinebesprechungen
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/metadataContent
Antwort
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
00:00:16.246 --> 00:00:17.726
{"startDateTime":"2023-03-08T08:22:30.0461639+00:00","endDateTime":"2023-03-08T08:22:31.5261639+00:00","speakerName":"User Name","spokenText":"This is a transcription test.","spokenLanguage":"en-us"}
Beispiel 10: Abrufen von callTranscript metadataContent für Ad-hoc-Aufrufe
Anforderung
GET https://graph.microsoft.com/beta/users/f2e8e111-3887-4936-87f8-639292c70d34/adhocCalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyMjMTk6NWFiOWQ2OGUxNDhlNDgyNThmYmMzOWYwOGUzOTkyN2NAdGhyZWFkLnYyIyM1ZjM2NDBlNy1hNTljLTRiZWMtODJjYS1lNjYyNTFmNzk1YjctMTc1NDg5MjIyMi1UcmFuc2NyaXB0VjIjIzA=/metadataContent
Antwort
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
00:00:03.663 --> 00:00:07.903
{"startDateTime":"2025-08-11T06:03:46.6390101+00:00","endDateTime":"2025-08-11T06:03:50.8790101+00:00","speakerName":"MOD Administrator","spokenText":"Hello. Hello. Hello. Hello. Hello. Hello.","spokenLanguage":"en-us"}
00:00:08.063 --> 00:00:08.103
{"startDateTime":"2025-08-11T06:03:51.0390101+00:00","endDateTime":"2025-08-11T06:03:51.0790101+00:00","speakerName":"MOD Administrator","spokenText":"Oh.","spokenLanguage":"en-us"}
Beispiel 11: Abrufen eines callTranscript aus einer entsprechenden Aufzeichnung mithilfe von contentCorrelationId
Das folgende Beispiel zeigt, wie Sie mithilfe der contentCorrelationId-Eigenschaft ein einzelnes Transkript einer Onlinebesprechung abrufen, das einer Aufzeichnung entspricht.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/me/onlineMeetings/MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/transcripts?$filter=contentcorrelationId+eq+'e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0'
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis
Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('1273a016-201d-4f95-8083-1b7f99b3edeb')/onlineMeetings('MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy')/transcripts",
"@odata.count": 1,
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET me/onlineMeetings('<key>')/transcripts('<key>')?$select=callId,content",
"value": [
{
"id": "VjIjIzExMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwNDA3ZjYyNjg0ZmQ0ZGEwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDRiZWQ5YTIzZGMyZmZmNDY4OTc4OTg0NjU2ZjI3MjE5IyNhMTRlZWNiZC0xM2RmLTRjN2EtOWM3ZC1mZDg3OGU0YTU4YTI=",
"meetingId": "MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy",
"callId": "26c38520-e74d-4391-8188-cb458d413825",
"contentCorrelationId": "e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0",
"transcriptContentUrl": "https://graph.microsoft.com/beta/users/1273a016-201d-4f95-8083-1b7f99b3edeb/onlineMeetings/MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/transcripts/VjIjIzExMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwNDA3ZjYyNjg0ZmQ0ZGEwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDRiZWQ5YTIzZGMyZmZmNDY4OTc4OTg0NjU2ZjI3MjE5IyNhMTRlZWNiZC0xM2RmLTRjN2EtOWM3ZC1mZDg3OGU0YTU4YTI=/content",
"createdDateTime": "2024-07-12T11:37:59.0113199Z",
"endDateTime": "2024-07-12T11:37:59.0113199Z",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "1273a016-201d-4f95-8083-1b7f99b3edeb",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
}
}
}
]
}