Freigeben über

Abrufen von Änderungsbenachrichtigungen für Transkripte und Aufzeichnungen mithilfe von Microsoft Graph

Mit Änderungsbenachrichtigungen können Sie Änderungen an Transkripten und Aufzeichnungen abonnieren. Sie können benachrichtigt werden, wenn ein Transkript oder eine Aufzeichnung nach einer Onlinebesprechung oder einem Ad-hoc-Anruf verfügbar ist.

In diesem Artikel werden Szenarien für die Transkript- und Aufzeichnungsressourcen beschrieben. Weitere Informationen finden Sie unter Änderungsbenachrichtigungen für Microsoft Teams-Ressourcen.

Hinweis

Wenn Sie ein abonnement expirationDateTime anfordern, das mehr als eine Stunde in der Zukunft liegt, müssen Sie Lebenszyklusbenachrichtigungen abonnieren, indem Sie eine lifecycleNotificationUrl-Eigenschaft in Ihre Abonnementanforderung einschließen. Andernfalls schlägt Ihre Abonnementanforderung mit der folgenden Fehlermeldung fehl: lifecycleNotificationUrl ist für die Abonnementerstellung für diese Ressource erforderlich, wenn der wert für expirationDateTime 1 Stunde überschreitet.

Abonnieren von Transkripts, die auf Mandantenebene verfügbar sind

In diesem Abschnitt werden die Methoden zum Abonnieren von Transkripten beschrieben, die sowohl für Onlinebesprechungen als auch für Ad-hoc-Aufrufe auf Mandantenebene verfügbar sind.

Für Onlinebesprechungen

Um Änderungsbenachrichtigungen für ein transkript zu erhalten, das für jede Onlinebesprechung in einem Mandanten verfügbar ist, abonnieren Sie communications/onlineMeetings/getAllTranscripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Die Benachrichtigung für ein Transkript wird nur gesendet, wenn das Abonnement vor beginn der Transkription erfolgt. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt derzeit keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/onlineMeetings/getAllTranscriptsabonnieren.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingTranscript.Read.All

Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Beispiel

Das folgende Beispiel zeigt, wie Sie Onlinebesprechungstranskripte abonnieren, die auf Mandantenebene verfügbar sind.

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Für Ad-hoc-Aufrufe

Um Änderungsbenachrichtigungen für jedes Transkript zu erhalten, das für ad-hoc-Aufrufe in einem Mandanten verfügbar ist, abonnieren Sie communications/adhocCalls/getAllTranscripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung.

Hinweis

Dieser Ressourcentyp ist nur auf dem /beta Endpunkt verfügbar.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/adhocCalls/getAllTranscriptsabonnieren.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application CallTranscripts.Read.All

Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Beispiel

Das folgende Beispiel zeigt, wie Sie Ad-hoc-Anruftranskripte abonnieren, die auf Mandantenebene verfügbar sind.

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "{expirationDateTime}",
  "clientState": "{secretClientState}"
}

Abonnieren von Transkripten, die für eine bestimmte Onlinebesprechung verfügbar sind

Um Änderungsbenachrichtigungen für ein transkript zu erhalten, das für eine bestimmte Onlinebesprechung verfügbar ist, abonnieren Sie communications/onlineMeetings/{onlineMeetingId}/transcripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Die Benachrichtigung für ein Transkript wird nur gesendet, wenn das Abonnement vor beginn der Transkription erfolgt. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt derzeit keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/onlineMeetings/{onlineMeetingId}/transcriptsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetingTranscript.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All

Hinweis

  • Die OnlineMeetingTranscript.Read.Chat Berechtigung verwendet die ressourcenspezifische Zustimmung. Diese Berechtigung gilt nur für geplante private Chatbesprechungen, nicht für Kanalbesprechungen.
  • Um ein für eine bestimmte Onlinebesprechung verfügbares Transkript mit nur erforderlichen ressourcenspezifischen Zustimmungsberechtigungen zu abonnieren, verwenden Sie den useResourceSpecificConsentBasedAuthorization=true Abfrageparameter mit Ihrer Ressourcenzeichenfolge.

Beispiel 1: Abonnieren von Transkripts, die für eine bestimmte Onlinebesprechung mit klassischen Berechtigungen verfügbar sind

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Transkripts, die für einen bestimmten Ad-hoc-Aufruf verfügbar sind

Um Änderungsbenachrichtigungen für ein transkript zu erhalten, das für einen bestimmten Ad-hoc-Aufruf verfügbar ist, abonnieren Sie communications/adhocCalls/{adhocCallId}/transcripts.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/adhocCalls/{adhocCallId}/transcriptsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) CallTranscripts.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application Nicht unterstützt

Beispiel: Abonnieren von Transkripts, die für einen bestimmten Ad-hoc-Aufruf mit klassischen Berechtigungen verfügbar sind

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/{adhocCallId}/transcripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Transkripts, die für Onlinebesprechungen verfügbar sind, die von einem Benutzer organisiert werden

Um Änderungsbenachrichtigungen für jedes Transkript zu erhalten, das für jede Onlinebesprechung verfügbar ist, die von einem bestimmten Benutzer organisiert wird, abonnieren Sie users/{userId}/onlineMeetings/getAllTranscripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Die Benachrichtigung für ein Transkript wird nur gesendet, wenn das Abonnement vor beginn der Transkription erfolgt. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt derzeit keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu users/{userId}/onlineMeetings/getAllTranscriptsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetingTranscript.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingTranscript.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Transkripte abonnieren, die für jede Onlinebesprechung verfügbar sind, die von einem bestimmten Benutzer organisiert wird.

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Transkripten, die für Ad-hoc-Aufrufe verfügbar sind, bei denen ein bestimmter Benutzer die Transkription initiiert

Um Änderungsbenachrichtigungen für jedes Transkript zu erhalten, das für einen Ad-hoc-Aufruf verfügbar ist, bei dem ein bestimmter Benutzer die Transkription initiiert, abonnieren Sie users/{userId}/adhocCalls/getAllTranscripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Die Benachrichtigung für ein Transkript wird nur gesendet, wenn das Abonnement vor beginn der Transkription erfolgt. Dieses Abonnement unterstützt Ad-hoc-Aufrufe.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu users/{userId}/adhocCalls/getAllTranscriptsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) CallTranscripts.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application CallTranscripts.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Transkripte abonnieren, die für jeden Ad-hoc-Aufruf verfügbar sind, bei dem ein bestimmter Benutzer die Transkription initiiert.

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/adhocCalls/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Transkripten, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App installiert ist

Um Änderungsbenachrichtigungen für jedes Transkript zu erhalten, das für jede Onlinebesprechung verfügbar ist, auf der eine bestimmte Teams-App installiert ist, abonnieren Sie appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Die Benachrichtigung für ein Transkript wird nur gesendet, wenn das Abonnement vor beginn der Transkription erfolgt. Dieses Abonnement unterstützt geplante Onlinemeetings , aber keine Kanalbesprechungen.

Hinweis

Dieser Ressourcentyp ist nur auf dem /beta Endpunkt verfügbar.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscriptsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All

Hinweis

  • Die OnlineMeetingTranscript.Read.Chat Berechtigung verwendet die ressourcenspezifische Zustimmung.
  • Verwenden Sie den Abfrageparameter mit Ihrer Ressourcenzeichenfolge, um Transkripte zu abonnieren, die für jede Onlinebesprechung verfügbar sind, in der useResourceSpecificConsentBasedAuthorization=true eine bestimmte Teams-App installiert ist.

Beispiel 1: Abonnieren von Transkripten, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App mit klassischen Berechtigungen installiert ist

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Aufzeichnungen, die auf Mandantenebene verfügbar sind

In diesem Abschnitt werden die Methoden zum Abonnieren von Aufzeichnungen beschrieben, die sowohl für Onlinebesprechungen als auch für Ad-hoc-Aufrufe auf Mandantenebene verfügbar sind.

Für Onlinebesprechungen

Um Änderungsbenachrichtigungen für jede aufzeichnung zu erhalten, die für jede Onlinebesprechung in einem Mandanten verfügbar ist, abonnieren Sie communications/onlineMeetings/getAllRecordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/onlineMeetings/getAllRecordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingRecording.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Aufzeichnungen abonnieren, die auf Mandantenebene für Onlinebesprechungen verfügbar sind.

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Für Ad-hoc-Aufrufe

Um Änderungsbenachrichtigungen für jede Aufzeichnung zu erhalten, die für ad-hoc-Aufrufe in einem Mandanten verfügbar ist, abonnieren Sie communications/adhocCalls/getAllRecordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt adhocCalls.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/adhocCalls/getAllRecordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application CallRecordings.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Aufzeichnungen abonnieren, die auf Mandantenebene verfügbar sind.

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Aufzeichnungen, die für eine bestimmte Onlinebesprechung verfügbar sind

Um Änderungsbenachrichtigungen für jede aufzeichnung zu erhalten, die für eine bestimmte Onlinebesprechung verfügbar ist, abonnieren Sie communications/onlineMeetings/{onlineMeetingId}/recordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt derzeit keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/onlineMeetings/{onlineMeetingId}/recordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetingRecording.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

Hinweis

  • Die OnlineMeetingRecording.Read.Chat Berechtigung verwendet die ressourcenspezifische Zustimmung. Diese Berechtigung gilt nur für geplante private Chatbesprechungen, nicht für Kanalbesprechungen.
  • Um aufzeichnungen, die für eine bestimmte Onlinebesprechung verfügbar sind, mit nur erforderlichen ressourcenspezifischen Zustimmungsberechtigungen zu abonnieren, verwenden Sie den useResourceSpecificConsentBasedAuthorization=true Abfrageparameter mit Ihrer Ressourcenzeichenfolge.

Beispiel 1: Abonnieren von Aufzeichnungen, die für eine bestimmte Onlinebesprechung mit klassischen Berechtigungen verfügbar sind

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Aufzeichnungen, die für einen bestimmten Ad-hoc-Anruf verfügbar sind

Um Änderungsbenachrichtigungen für eine aufzeichnung zu erhalten, die für einen bestimmten Ad-hoc-Anruf verfügbar ist, abonnieren Sie communications/adhocCalls/{adhocCallId}/recordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt Ad-hoc-Aufrufe.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/adhocCalls/{adhocCallId}/recordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) CallRecordings.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application CallRecordings.Read.All

Beispiel: Abonnieren von Aufzeichnungen, die für einen bestimmten Ad-hoc-Aufruf mit klassischen Berechtigungen verfügbar sind

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/{adhocCallId}/recordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Aufzeichnungen für Onlinebesprechungen, die von einem Benutzer organisiert werden

Um Änderungsbenachrichtigungen für alle Aufzeichnungen zu erhalten, die für jede Onlinebesprechung verfügbar sind, die von einem bestimmten Benutzer organisiert wird, abonnieren Sie users/{userId}/onlineMeetings/getAllRecordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt geplante OnlineMeetings.

Hinweis

Dieses Abonnement unterstützt derzeit keine Besprechungen im privaten Kanal.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu users/{userId}/onlineMeetings/getAllRecordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetingRecording.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingRecording.Read.All

Abonnieren von Aufzeichnungen, die für Ad-hoc-Aufrufe verfügbar sind, bei denen ein bestimmter Benutzer die Transkription initiiert

Um Änderungsbenachrichtigungen für alle Aufzeichnungen zu erhalten, die für ad-hoc-Aufrufe verfügbar sind, bei denen ein bestimmter Benutzer die Transkription initiiert, abonnieren Sie users/{userId}/adhocCalls/getAllRecordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt Ad-hoc-Aufrufe.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu users/{userId}/adhocCalls/getAllRecordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) CallRecordings.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application CallRecordings.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Aufzeichnungen abonnieren, die für jeden Ad-hoc-Aufruf verfügbar sind, bei dem ein bestimmter Benutzer die Transkription initiiert.

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/adhocCalls/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Abonnieren von Aufzeichnungen, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App installiert ist

In diesem Abschnitt werden die Methoden zum Abonnieren von Aufzeichnungen beschrieben, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App installiert ist.

Um Änderungsbenachrichtigungen für jede Aufzeichnung zu erhalten, die für jede Onlinebesprechung verfügbar ist, auf der eine bestimmte Teams-App installiert ist, abonnieren Sie appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Diese Ressource unterstützt das Einbeziehen von Ressourcendaten in die Benachrichtigung. Dieses Abonnement unterstützt geplante Onlinemeetings , aber keine Kanalbesprechungen.

Hinweis

Dieser Ressourcentyp ist nur auf dem /beta Endpunkt verfügbar.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordingsabonnieren. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

Hinweis

  • Die OnlineMeetingRecording.Read.Chat Berechtigung verwendet die ressourcenspezifische Zustimmung.
  • Verwenden Sie den Abfrageparameter mit Ihrer Ressourcenzeichenfolge, um Aufzeichnungen zu abonnieren, die für jede Onlinebesprechung verfügbar sind, in der useResourceSpecificConsentBasedAuthorization=true eine bestimmte Teams-App installiert ist.

Beispiel 1: Abonnieren von Aufzeichnungen, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App mit den erforderlichen klassischen Berechtigungen installiert ist

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Nutzlast der Benachrichtigung

Abhängig von Ihrem Abonnement können Sie die Benachrichtigung mit oder ohne Ressourcendaten erhalten. Wenn Sie Ressourcendaten abonnieren, können Sie die Transkript- oder Aufzeichnungsmetadaten zusammen mit der Benachrichtigung abrufen.

Benachrichtigungen mit Ressourcendaten für Transkripte

Bei Benachrichtigungen mit Ressourcendaten sieht die Nutzlast wie folgt aus. Diese Nutzlast ist für ein Transkript vorgesehen, das für eine Onlinebesprechung verfügbar ist. Bei Ad-hoc-Aufrufen ist nulldie meetingId .

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

Für Onlinebesprechungen

{
  "value": [
    {
      "subscriptionId": "516220d0-0f88-46cc-ac39-02b687687526",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:13:26.3265566+00:00",
      "resource": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')",
      "resourceData": {
        "id": "MSM...",
        "@odata.type": "#Microsoft.Graph.callTranscript",
        "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Für Ad-hoc-Aufrufe

{
  "value": [
    {
      "subscriptionId": "8c0ff21a-ca3b-45db-b570-e589a7d3d02d",
      "changeType": "created",
      "clientState": "null",
      "subscriptionExpirationDateTime": "2025-08-08T06:29:30.356Z",
      "resource": "users/f2e8e111-3887-4936-87f8-639292c70d34/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts('MyM...')",
      "resourceData": {
        "id": "f2e8e111-3887-4936-87f8-639292c70d34",
        "@odata.type": "#Microsoft.Graph.callTranscript",
        "@odata.id": "users/{user-id}/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts('MyM...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Entschlüsselte Benachrichtigungen für Transkripte mit Ressourcendaten

Die entschlüsselte Benachrichtigungsnutzlast sieht wie folgt aus. Die Nutzlast entspricht dem Transkriptschema . Die Nutzlast ähnelt denen, die von GET-Vorgängen zurückgegeben werden.

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

Für Onlinebesprechungen

{
  "id": "MSM...",
  "meetingId": "MSo...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "transcriptContentUrl": "users/{organizer-id}/onlineMeetings/MSo.../transcripts/MSM.../content",
  "createdDateTime": null,
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  }
}

Für Ad-hoc-Aufrufe

{
  "id": "MyM...",
  "meetingId": null,
  "callId": "5f3640e7-a59c-4bec-82ca-e66251f795b7",
  "transcriptContentUrl": "users/f2e8e111-3887-4936-87f8-639292c70d34/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyM.../content",
  "createdDateTime": null,
  "endDateTime": "2025-08-11T06:57:28.2265904Z",
  "contentCorrelationId": "58cfc66a-710f-4be7-adc0-1ca5a28f2c0c-0",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "f2e8e111-3887-4936-87f8-639292c70d34",
      "displayName": null,
      "tenantId": "8393309d-9fb7-4cce-aafb-eedc8c5781e2"
    }
  }
}

Benachrichtigungen mit Ressourcendaten für Aufzeichnungen

Bei Benachrichtigungen mit Ressourcendaten sieht die Nutzlast wie folgt aus.

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

Für Onlinebesprechungen

{
  "value": [
    {
      "subscriptionId": "7a62d59e-a789-4dd7-9c85-cf7d6567890d",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:20:06.9211285+00:00",
      "resource": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')",
      "resourceData": {
        "id": "VjI...",
        "@odata.type": "#Microsoft.Graph.callRecording",
        "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Für Ad-hoc-Aufrufe

{
  "value": [
    {
      "subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
      "resource": "users/{user-id}/adhoccalls('1c9ddbc9-82be-46b6-8edd-bf833fe33a03')/recordings('MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=')",
      "resourceData": {
        "id": "MyM...",
        "@odata.type": "#Microsoft.Graph.callRecording",
        "@odata.id": "users/{user-id}/adhoccalls('1c9ddbc9-82be-46b6-8edd-bf833fe33a03')/recordings(MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=)",
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Entschlüsselte Benachrichtigungen für Aufzeichnungen mit Ressourcendaten

Die entschlüsselte Benachrichtigungsnutzlast sieht wie folgt aus. Die Nutzlast entspricht dem Aufzeichnungsschema . Die Nutzlast ähnelt denen, die von GET-Vorgängen zurückgegeben werden.

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

{
  "id": "VjI...",
  "meetingId": "MSo...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "createdDateTime": "2023-07-25T09:35:02.85022Z",
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "recordingContentUrl": "users/{organizer-id}/MSo.../recordings/VjI.../content",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  },
  "content": null
}

Benachrichtigungen ohne Ressourcendaten

Benachrichtigungen ohne Ressourcendaten enthalten die Ressourcen-ID, um GET-Aufrufe zum Abrufen des Transkripts oder der Aufzeichnung zu tätigen. Abonnements für Benachrichtigungen ohne Ressourcendaten erfordern kein Verschlüsselungszertifikat (da die tatsächlichen Ressourcendaten nicht gesendet werden).

Bei Benachrichtigungen ohne Ressourcendaten sieht die Nutzlast wie folgt aus.

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

Für Onlinebesprechungstranskripte

{
  "subscriptionId": "0cc28c98-4d2a-4a34-b850-815d7e6486ea",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:29:11.3173971+00:00",
  "resource": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')",
  "resourceData": {
    "id": "MSM...",
    "@odata.type": "#Microsoft.Graph.callTranscript",
    "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')"
  }
}

Für Ad-hoc-Anruftranskripte

Bei Benachrichtigungen ohne Ressourcendaten sieht die Nutzlast wie folgt aus. Diese Nutzlast ist für ein Transkript vorgesehen, das für einen Ad-hoc-Aufruf verfügbar ist. Bei Ad-hoc-Aufrufen ist nulldie meetingId .

{
  "subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
  "changeType": "created",
  "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
  "resource": "users/{user-id}/adhocCalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/transcripts/MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=",
  "resourceData": {
    "id": "MyM...",
    "@odata.type": "#Microsoft.Graph.callTranscript",
    "@odata.id": "users/{user-id}/adhoccalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/transcripts('MyM...')"
  }
}

Bei Benachrichtigungen ohne Ressourcendaten sieht die Nutzlast wie folgt aus.

Hinweis

Das hier gezeigte Nutzlastobjekt ist zur Lesbarkeit gekürzt.

Für Onlinebesprechungsaufzeichnungen

{
  "subscriptionId": "6aa5ced2-0a5a-4643-9274-3109c731d986",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:27:05.0241757+00:00",
  "resource": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')",
  "resourceData": {
    "id": "VjI...",
    "@odata.type": "#Microsoft.Graph.callRecording",
    "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')"
  }
}

Für Ad-hoc-Anrufaufzeichnungen

{
"subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
  "changeType": "created",
  "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
  "resource": "users/{user-id}/adhoccalls/adhocCalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/recordings('MyM...')",
  "resourceData": {
    "id": "MyM...",
    "@odata.type": "#Microsoft.Graph.callRecording",
    "@odata.id": "users/{user-id}/adhoccalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/recordings('MyM...')"
  }
}

Die Eigenschaften ressource und @odata.id können verwendet werden, um Microsoft Graph aufzurufen, um das Transkript oder die Aufzeichnung abzurufen.

Verwandte Inhalte

  • Last updated on