Abrufen von Änderungsbenachrichtigungen für Besprechungstranskripte und -aufzeichnungen mithilfe von Microsoft Graph

Artikel
12/28/2024

Mit Änderungsbenachrichtigungen können Sie Änderungen an Transkripten und Aufzeichnungen abonnieren. Sie können benachrichtigt werden, wenn nach einer Onlinebesprechung ein Transkript oder eine Aufzeichnung 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.

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um zu communications/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)	Nicht unterstützt
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	OnlineMeetingTranscript.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Transkripte 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}"
}

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

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

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

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

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
Anwendung	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}"
}

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.

Anmerkung: 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
Anwendung	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.

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

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

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
Anwendung	OnlineMeetingRecording.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Aufzeichnungen 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/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

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

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

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.

Anmerkung: Dieses Abonnement unterstützt auch Kanalbesprechungen auf dem /beta Endpunkt.

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
Anwendung	OnlineMeetingRecording.Read.All

Beispiel

Das folgende Beispiel zeigt, wie Sie Aufzeichnungen 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/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

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.

Anmerkung: 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
Anwendung	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.

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

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.

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

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.

{
  "id": "MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx",
  "meetingId": "MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "transcriptContentUrl": "communications/onlineMeetings/MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy/transcripts/MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx/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"
    }
  }
}

Bei Benachrichtigungen mit Ressourcendaten sieht die Nutzlast wie folgt aus. Diese Nutzlast ist für eine Aufzeichnung vorgesehen, die für eine Onlinebesprechung verfügbar ist.

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

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.

{
  "id": "VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=",
  "meetingId": "MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy",
  "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": "communications/onlineMeetings/MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy/recordings/VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=/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. Diese Nutzlast ist für ein Transkript vorgesehen, das für eine Onlinebesprechung verfügbar ist.

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

Bei Benachrichtigungen ohne Ressourcendaten sieht die Nutzlast wie folgt aus. Diese Nutzlast ist für eine Aufzeichnung vorgesehen, die für eine Onlinebesprechung verfügbar ist.

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

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

Freigeben über

Abrufen von Änderungsbenachrichtigungen für Besprechungstranskripte und -aufzeichnungen mithilfe von Microsoft Graph

Berechtigungen

Beispiel

Berechtigungen

Berechtigungen

Beispiel

Berechtigungen

Berechtigungen

Beispiel

Berechtigungen

Berechtigungen

Beispiel

Berechtigungen

Nutzlast der Benachrichtigung

Benachrichtigungen mit Ressourcendaten

Benachrichtigungen ohne Ressourcendaten

Feedback

Zusätzliche Ressourcen

Freigeben über

Abrufen von Änderungsbenachrichtigungen für Besprechungstranskripte und -aufzeichnungen mithilfe von Microsoft Graph

Abonnieren von Transkripts, die auf Mandantenebene verfügbar sind

Berechtigungen

Beispiel

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

Berechtigungen

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

Beispiel 2: Abonnieren von Transkripts, die für eine bestimmte Onlinebesprechung mit ressourcenspezifischen Zustimmungsberechtigungen verfügbar sind

Abonnieren von Transkripts, die auf Benutzerebene verfügbar sind

Berechtigungen

Beispiel

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

Berechtigungen

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

Beispiel 2: Abonnieren von Transkripts, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App nur mit ressourcenspezifischen Zustimmungsberechtigungen installiert ist

Abonnieren von Aufzeichnungen, die auf Mandantenebene verfügbar sind

Berechtigungen

Beispiel

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

Berechtigungen

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

Beispiel 2: Abonnieren von Aufzeichnungen, die für eine bestimmte Onlinebesprechung verfügbar sind, nur mit ressourcenspezifischen Zustimmungsberechtigungen

Abonnieren von Aufzeichnungen, die auf Benutzerebene verfügbar sind

Berechtigungen

Beispiel

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

Berechtigungen

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

Beispiel 2: Abonnieren von Aufzeichnungen, die für jede Onlinebesprechung verfügbar sind, in der eine bestimmte Teams-App nur mit ressourcenspezifischen Zustimmungsberechtigungen installiert ist

Nutzlast der Benachrichtigung

Benachrichtigungen mit Ressourcendaten

Benachrichtigungen ohne Ressourcendaten

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen