CallTranscript abrufen

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-Anruf zugeordnet ist. Diese API unterstützt das Abrufen von Anruftranskripten aus privaten Chat- und Kanalbesprechungen sowie Ad-hoc-Anrufe, einschließlich PSTN-, 1:1- und Gruppenanrufe. 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 Textstrom zurückgegeben, der dem Transkript zugeordnet ist.

Hinweis

Für Onlinebesprechungen:

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 die 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 sie einem Benutzer gewähren. Er autorisiert die in der Richtlinie konfigurierte App, Onlinebesprechungen und/oder Onlinebesprechungsartefakte im Namen dieses Benutzers (mit der im Anforderungspfad angegebenen Benutzer-ID) abzurufen. Weitere Informationen finden Sie unter Zulassen, dass Anwendungen im Namen eines Benutzers auf Onlinebesprechungen zugreifen.

Hinweis

Für Onlinebesprechungen:

  • Diese API ist für eine Besprechung verfügbar, die nicht abgelaufen ist. Weitere Informationen finden Sie unter Limits und Spezifikationen für Microsoft Teams.
  • Diese API ist auch für Benutzer verfügbar, die Teil der Besprechungskalendereinladung sind, die sowohl für private Chatbesprechungen als auch für Kanalbesprechungen gilt.

Mandantenadministratorsteuerung für Transkriptzugriff

Der Zugriff auf Transkripte über diese API erfordert die entsprechenden Graph-Berechtigungen und wird außerdem durch zwei unabhängige Mandantenadministratoreinstellungen gesteuert:

  • Graph-API-Zugriff auf Transkripte. Wenn diese Option deaktiviert ist, werden alle Transkriptanforderungen (Metadaten metadataContentund content) unabhängig vom angeforderten Format mit dem GraphAccessToTranscriptsDisabled inneren Fehlercode zurückgegeben403 Forbidden.

  • Zuschreibung des Sprechers. 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 zeitgestempelten Äußerungen und <v Speaker> Sprachtags (vom Sprecher zugeordnet).
  • application/vnd.microsoft.graph.transcript+text — Äußerungen mit Zeitstempeln ohne Sprecherinformationen (Sprecher-nicht zugeschrieben).

Wählen Sie entweder mit dem Accept Header- oder dem $format Abfrageparameter austext/vtt. Das application/vnd.microsoft.graph.transcript+text Format muss mit der Accept Kopfzeile ausgewählt werden; es wird vom $format Abfrageparameter nicht unterstützt.

Wenn der Mandantenadministrator die Sprecherzuordnung deaktiviert hat, wird das zugeordnete Format (text/vtt) mit dem SpeakerAttributionNotAllowed inneren Fehlercode zurückgegeben403 Forbidden. Wiederholen Sie den Vorgang mit dem nicht zugeordneten Format, um das Transkript abzurufen. Die Einstellung für die Sprecherzuordnung blockiert nie das nicht zugeordnete Format, unterliegt jedoch weiterhin der Einstellung für den Zugriff auf Transkripte der Graph-API.

Hinweis

Das application/vnd.microsoft.graph.transcript+text Format und die zugehörigen Steuerelemente für Mandantenadministratoren werden Ende Juli 2026 wirksam.

HTTP-Anforderung

Wählen Sie auf den /content Endpunkten das Transkript-Inhaltsformat mit dem Accept Anforderungsheader aus, wie unter Transkript-Inhaltsformate 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 die Transkription als auch die 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 eine Ad-hoc-Anruf

GET /me/adhocCalls/{callId}/transcripts/{transcriptId}
GET /users/{userId}/adhocCalls/{callId}/transcripts/{transcriptId}

Abrufen des Inhalts eines einzelnen Transkripts für einen Ad-hoc-Anruf

  • Sowohl die Transkription als auch die 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 diese Methode einen 200 OK Antwortcode und ein callTranscript-Objekt im Antworttext zurück.

Transkript-Inhaltsformate

Der /content Endpunkt unterstützt die folgenden Formate. Wählen Sie entweder mit dem $format Abfrageparameter oder dem Accept Anforderungsheader austext/vtt. Das application/vnd.microsoft.graph.transcript+text Format muss mit dem Accept Anforderungsheader ausgewählt werden.

Format Sprecher-Attribution Beschreibung
text/vtt Ja WebVTT mit zeitgestempelten Äußerungen und <v Speaker> Sprachtags. Wird standardmäßig zurückgegeben.
application/vnd.microsoft.graph.transcript+text Nein Nur Äußerungen mit Zeitstempel, ohne <v Speaker> Sprachtags.

Wenn der Mandant die Zuordnung des text/vtt Sprechers nicht zulässt, schlagen Anforderungen stattdessen mitSpeakerAttributionNotAllowed403 Forbidden / ;-Anforderung fehl.application/vnd.microsoft.graph.transcript+text

Fehlerantworten

Diese API unterliegt den Einstellungen der Mandantenadministratoren für den Transkriptzugriff und die Zuordnung von Sprechern. Verzweigung nach dem innerError.code Wert, nicht nach dem Meldungstext. Nachrichten können sich ändern.

Der Zugriff der Graph-API auf Transkripte ist deaktiviert

Wenn ein Mandantenadministrator den Zugriff der Graph-API 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 problemseitige Problemumgehung auf der Anforderungsseite. Die App erhält 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"
    }
  }
}

Von Sprechern zugeordnete Inhalte sind deaktiviert

Wenn ein Mandantenadministrator die Sprecherzuordnung nicht zulässt, geben die /content Endpunkte nur dann den SpeakerAttributionNotAllowed inneren Fehlercode zurück403 Forbidden, wenn die Anforderung nach einem vom Lautsprecher zugeordneten Format (text/vtt) fragt. Wiederholen Sie dieselbe Anforderung und fragen Sie nach dem nicht zugeordneten Format, application/vnd.microsoft.graph.transcript+textwas 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 seit 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 einen Ad-hoc-Anruf

Das folgende Beispiel zeigt, wie Sie ein einzelnes Transkript eines Ad-hoc-Anrufs erhalten.

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, in der Inhalte mit Sprecherzuordnung 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 weisen darauf hin, dass die Transkription begann, während das Gespräch noch lief.

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 der dem Sprecher zugeordnete Inhalt deaktiviert ist

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 Textkörper als Bytes. Die content-type Kopfzeile gibt den Typ des Transkriptinhalts an. Negative Offsets weisen darauf hin, dass die Transkription begann, während das Gespräch noch lief.

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 die von den Sprechern zugeordneten Inhalte deaktiviert sind

Das folgende Beispiel zeigt, wie Sie den Inhalt eines einzelnen Transkripts einer Onlinebesprechung abrufen, wenn die von Sprechern zugeordneten 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 Textkörper als Bytes. Die content-type Kopfzeile gibt den Typ des Transkriptinhalts an. Negative Offsets weisen darauf hin, dass die Transkription begann, während das Gespräch noch lief.

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 zugeordnetem callTranscript-Inhalt

Das folgende Beispiel zeigt, wie Transkriptinhalte ohne Sprecherzuordnung abgerufen werden können. Fordern Sie dieses Format mithilfe der Kopfzeile 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 Textkörper 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 nach einem attributierten Format (text/vtt) fragt. Wiederholen Sie den Vorgang application/vnd.microsoft.graph.transcript+text , um das nicht zugeordnete 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 Inhalte mit Sprecherattribute aktiviert sind

Das folgende Beispiel zeigt, wie Sie den Inhalt eines einzelnen Transkripts eines Ad-hoc-Anrufs abrufen, wenn sprecherzugeordneter Inhalt aktiviert ist.

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 Textkörper als Bytes. Die content-type Kopfzeile gibt den Typ des Transkriptinhalts an. Negative Offsets weisen darauf hin, dass die Transkription begann, während das Gespräch noch lief.

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 eines callTranscript-MetadatenInhalts 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 eines callTranscript-Metadateninhalts für Ad-hoc-Anrufe

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 können, 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"
                }
            }
        }
    ]
}
  • Last updated on