Abrufen von Transkripten mithilfe von Graph-APIs
Verwenden Sie Graph-REST-APIs, um Transkripte für eine bestimmte Besprechung abzurufen. Ihre App ruft die Transkripte basierend auf der Benutzer-ID des Besprechungsorganisators und der Besprechungs-ID ab.
Die folgenden APIs werden zum Abrufen von Transkripten verwendet:
CallTranscripts auflisten
Diese API wird verwendet, um eine Liste aller callTranscriptObjekte basierend auf der Benutzer-ID und Besprechungs-ID abzurufen. Sie gibt die Metadaten der Transkripts der Besprechung zurück, die die Transkript-ID und das Erstellungsdatum und die Erstellungszeit dieses Transkripts enthalten.
HTTP-Anforderung
GET /me/onlineMeetings('{meetingId}')/transcripts
GET /users('{userId}')/onlineMeetings('{meetingId}')/transcripts
Optionale Abfrageparameter
Die -Methode unterstützt die $skipTokenOData-Abfrageparameter und $top , um die Antwort anzupassen.
Unterstützte Abfragemuster
| Muster | Unterstützt | Syntax | Anmerkungen |
|---|---|---|---|
| Serverseitige Paginierung | ✓ | @odata.nextLink |
Rufen Sie ein Fortsetzungstoken in der Antwort ab, wenn sich eine Ergebnismenge über mehrere Seiten erstreckt. |
| Seitenlimit | ✓ | /transcripts?$top=20 |
Transkripte mit Seitengröße 20 abrufen. Der Standardseitengrenzwert ist 10. Das maximale Seitenlimit beträgt 100. |
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich ist, werden ein 200 OK Antwortcode und eine Auflistung von callTranscript Objekten im Antworttext zurückgegeben.
Beispiel: Liste von callTranscript
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts
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('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts",
"@odata.count": 3,
"@odata.nextLink": "https://graph.microsoft.com/beta/users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts?$skiptoken=MSMjMCMjMjAyMS0wOS0xNlQxMzo1OToyNy4xMjEwMzgzWg%3d%3d",
"value": [
{
"id": "MSMjMCMjZDAwYWU3NjUtNmM2Yi00NjQxLTgwMWQtMTkzMmFmMjEzNzdh",
"createdDateTime": "2021-09-17T06:09:24.8968037Z"
},
{
"id": "MSMjMCMjMzAxNjNhYTctNWRmZi00MjM3LTg5MGQtNWJhYWZjZTZhNWYw",
"createdDateTime": "2021-09-16T18:58:58.6760692Z"
},
{
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"createdDateTime": "2021-09-16T18:56:00.9038309Z"
}
]
}
CallTranscript abrufen
Ihre Anwendung durchsucht die Liste der Transkript-IDs, die sie als Antwort von der List callTranscripts-API erhält, um die gewünschte Transkript-ID zu ermitteln. Diese API wird verwendet, um einzelne Transkriptmetadaten auf der Grundlage der Benutzer-ID, der Besprechungs-ID und der Transkript-ID zu erhalten.
HTTP-Anforderung
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich ist, werden ein 200 OK Antwortcode und ein callTranscript Objekt im Antworttext zurückgegeben.
Beispiel: Abrufen eines callTranscript-Codes
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4
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('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/$entity",
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"createdDateTime": "2021-09-17T06:09:24.8968037Z"
}
Abrufen von callTranscript-Inhalten
Diese API wird verwendet, um das Transkript der ausgewählten Transkript-ID abzurufen, die in der Antwort der Get callTranscript API erhalten wurde. Sie gibt den Inhalt des Transkripts zurück.
HTTP-Anforderung
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
Optionale Abfrageparameter
Diese Methode unterstützt den $formatOData-Abfrageparameter , der die Antwortanpassung ermöglicht.
Die unterstützten Formattypen sindtext/vttfür das VTT- ODERapplication/vnd.openxmlformats-officedocument.wordprocessingml.documentfür das DOCX-Format.
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. |
| Annehmen | text/vtt OR application/vnd.openxmlformats-officedocument.wordprocessingml.document. Optional. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode zurück und enthält Bytes für das callTranscript-Objekt im Antworttext. Der content-type Header gibt den Typ des Transkriptinhalts an.
Beispiele
Beispiel: Abrufen eines callTranscript-Inhalts
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. 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: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Beispiel: Abrufen eines callTranscript-Inhalts, der $format Abfrageparameter angibt
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Antwort
Die Antwort enthält Bytes für das Transkript im Text. 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: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Beispiel: Abrufen eines callTranscript-Inhalts, der accept-Header angibt
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Antwort
Die Antwort enthält Bytes für das Transkript im Text. 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.openxmlformats-officedocument.wordprocessingml.document
0:0:0.0 --> 0:0:5.320
User Name
This is a transcript test.
Beispiel: Abrufen eines callTranscript-Inhalts mit $format Vorrang vor dem accept-Header
Anforderung
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Antwort
Die Antwort enthält Bytes für das Transkript im Text. 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: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für