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.

Rufen Sie die Liste der callTranscript-Objekte ab, die einer geplanten Online-Besprechung zugeordnet sind. Diese API unterstützt das Abrufen von Anruftranskripten aus privaten Chatbesprechungen und Kanalbesprechungen. Der Zugriff auf diese API unterliegt den Einstellungen des Mandantenadministrators. Siehe Fehlerantworten.

Hinweis

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
Application OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read. Chat 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 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

  • 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.

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

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und eine Auflistung von callTranscript-Objekten im Antworttext zurück.

Fehlerantworten

Wenn ein Mandantenadministrator den Graph-API-Zugriff auf Transkripte für den Mandanten deaktiviert hat, wird diese Anforderung mit dem GraphAccessToTranscriptsDisabled internen 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"
    }
  }
}

Beispiele

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,
    "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",
                }
            }
        }        
    ]
}