Partager via

Recevoir des notifications de modification pour les transcriptions et les enregistrements à l’aide de Microsoft Graph

Les notifications de modification vous permettent de vous abonner aux modifications apportées aux transcriptions et aux enregistrements. Vous pouvez recevoir une notification chaque fois qu’une transcription ou un enregistrement est disponible après une réunion en ligne ou un appel ad hoc.

Cet article décrit des scénarios pour les ressources de transcription et d’enregistrement . Pour plus d’informations, consultez Notifications de modification pour les ressources Microsoft Teams.

Remarque

Si vous demandez un abonnement expirationDateTime supérieur à 1 heure à l’avenir, vous devez vous abonner aux notifications de cycle de vie en incluant une propriété lifecycleNotificationUrl dans votre demande d’abonnement. Sinon, votre demande d’abonnement échoue avec le message d’erreur suivant : lifecycleNotificationUrl est requis pour la création de l’abonnement sur cette ressource lorsque la valeur expirationDateTime dépasse 1 heure.

S’abonner aux transcriptions disponibles au niveau du locataire

Cette section décrit les méthodes permettant de s’abonner aux transcriptions disponibles au niveau du locataire pour les réunions en ligne et les appels ad hoc.

Pour les réunions en ligne

Pour obtenir des notifications de modification pour toute transcription disponible pour toute réunion en ligne dans un locataire, abonnez-vous à communications/onlineMeetings/getAllTranscripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. La notification d’une transcription est envoyée uniquement si l’abonnement se produit avant le début de la transcription. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Actuellement, cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/onlineMeetings/getAllTranscripts.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingTranscript.Read.All

Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Exemple

L’exemple suivant montre comment s’abonner aux transcriptions de réunion en ligne disponibles au niveau du locataire.

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

Pour les appels ad hoc

Pour obtenir des notifications de modification pour toute transcription disponible pour tout appel ad hoc dans un locataire, abonnez-vous à communications/adhocCalls/getAllTranscripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification.

Remarque

Ce type de ressource est disponible uniquement sur le point de /beta terminaison.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/adhocCalls/getAllTranscripts.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CallTranscripts.Read.All

Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Exemple

L’exemple suivant montre comment s’abonner aux transcriptions d’appel ad hoc disponibles au niveau du locataire.

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

S’abonner aux transcriptions disponibles pour une réunion en ligne particulière

Pour obtenir des notifications de modification pour toute transcription disponible pour une réunion en ligne particulière, abonnez-vous à communications/onlineMeetings/{onlineMeetingId}/transcripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. La notification d’une transcription est envoyée uniquement si l’abonnement se produit avant le début de la transcription. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Actuellement, cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/onlineMeetings/{onlineMeetingId}/transcripts. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) OnlineMeetingTranscript.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All

Remarque

  • L’autorisation OnlineMeetingTranscript.Read.Chat utilise le consentement spécifique à la ressource. Cette autorisation s’applique uniquement aux réunions de conversation privée planifiées, et non aux réunions de canal.
  • Pour vous abonner à une transcription disponible pour une réunion en ligne particulière en utilisant uniquement les autorisations de consentement spécifiques à la ressource requises, utilisez le useResourceSpecificConsentBasedAuthorization=true paramètre de requête avec votre chaîne de ressource.

Exemple 1 : S’abonner aux transcriptions disponibles pour une réunion en ligne particulière à l’aide d’autorisations classiques

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

S’abonner aux transcriptions disponibles pour un appel ad hoc particulier

Pour obtenir des notifications de modification pour toute transcription disponible pour un appel ad hoc particulier, abonnez-vous à communications/adhocCalls/{adhocCallId}/transcripts.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/adhocCalls/{adhocCallId}/transcripts. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) CallTranscripts.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Exemple : S’abonner aux transcriptions disponibles pour un appel ad hoc particulier à l’aide d’autorisations classiques

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

S’abonner aux transcriptions disponibles pour les réunions en ligne organisées par un utilisateur

Pour obtenir des notifications de modification pour toute transcription disponible pour toute réunion en ligne organisée par un utilisateur spécifique, abonnez-vous à users/{userId}/onlineMeetings/getAllTranscripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. La notification d’une transcription est envoyée uniquement si l’abonnement se produit avant le début de la transcription. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Actuellement, cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à users/{userId}/onlineMeetings/getAllTranscripts. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) OnlineMeetingTranscript.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingTranscript.Read.All

Exemple

L’exemple suivant montre comment s’abonner aux transcriptions disponibles pour toute réunion en ligne organisée par un utilisateur spécifique.

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

S’abonner aux transcriptions disponibles pour un appel ad hoc où un utilisateur spécifique lance la transcription

Pour obtenir des notifications de modification pour toute transcription disponible pour tout appel ad hoc où un utilisateur spécifique lance la transcription, abonnez-vous à users/{userId}/adhocCalls/getAllTranscripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. La notification d’une transcription est envoyée uniquement si l’abonnement se produit avant le début de la transcription. Cet abonnement prend en charge les appels ad hoc.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à users/{userId}/adhocCalls/getAllTranscripts. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) CallTranscripts.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CallTranscripts.Read.All

Exemple

L’exemple suivant montre comment s’abonner aux transcriptions disponibles pour tout appel ad hoc où un utilisateur spécifique lance la transcription.

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

Abonnez-vous aux transcriptions disponibles pour toute réunion en ligne où une application Teams spécifique est installée

Pour obtenir des notifications de modification pour toute transcription disponible pour toute réunion en ligne où une application Teams spécifique est installée, abonnez-vous à appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. La notification d’une transcription est envoyée uniquement si l’abonnement se produit avant le début de la transcription. Cet abonnement prend en charge les réunions en ligne planifiées , mais pas les réunions de canal.

Remarque

Ce type de ressource est disponible uniquement sur le point de /beta terminaison.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All

Remarque

  • L’autorisation OnlineMeetingTranscript.Read.Chat utilise le consentement spécifique à la ressource.
  • Pour vous abonner aux transcriptions disponibles pour toute réunion en ligne où une application Teams spécifique est installée à l’aide uniquement des autorisations de consentement spécifiques à la ressource requises, utilisez le useResourceSpecificConsentBasedAuthorization=true paramètre de requête avec votre chaîne de ressource.

Exemple 1 : S’abonner aux transcriptions disponibles pour toute réunion en ligne où une application Teams spécifique est installée à l’aide d’autorisations classiques

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

S’abonner aux enregistrements disponibles au niveau du locataire

Cette section décrit les méthodes permettant de s’abonner aux enregistrements disponibles au niveau du locataire pour les réunions en ligne et les appels ad hoc.

Pour les réunions en ligne

Pour obtenir des notifications de modification pour tout enregistrement disponible pour toute réunion en ligne dans un locataire, abonnez-vous à communications/onlineMeetings/getAllRecordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/onlineMeetings/getAllRecordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingRecording.Read.All

Exemple

L’exemple suivant montre comment s’abonner aux enregistrements disponibles au niveau du locataire pour les réunions en ligne.

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

Pour les appels ad hoc

Pour obtenir des notifications de modification pour tout enregistrement disponible pour tout appel ad hoc dans un locataire, abonnez-vous à communications/adhocCalls/getAllRecordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge adhocCalls.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/adhocCalls/getAllRecordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CallRecordings.Read.All

Exemple

L’exemple suivant montre comment s’abonner aux enregistrements disponibles au niveau du locataire.

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

S’abonner aux enregistrements disponibles pour une réunion en ligne particulière

Pour obtenir des notifications de modification pour tout enregistrement disponible pour une réunion en ligne particulière, abonnez-vous à communications/onlineMeetings/{onlineMeetingId}/recordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Actuellement, cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/onlineMeetings/{onlineMeetingId}/recordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) OnlineMeetingRecording.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

Remarque

  • L’autorisation OnlineMeetingRecording.Read.Chat utilise le consentement spécifique à la ressource. Cette autorisation s’applique uniquement aux réunions de conversation privée planifiées, et non aux réunions de canal.
  • Pour vous abonner à un enregistrement disponible pour une réunion en ligne particulière en utilisant uniquement les autorisations de consentement spécifiques à la ressource requises, utilisez le useResourceSpecificConsentBasedAuthorization=true paramètre de requête avec votre chaîne de ressource.

Exemple 1 : S’abonner aux enregistrements disponibles pour une réunion en ligne particulière à l’aide d’autorisations classiques

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

S’abonner aux enregistrements disponibles pour un appel ad hoc particulier

Pour obtenir des notifications de modification pour tout enregistrement disponible pour un appel ad hoc particulier, abonnez-vous à communications/adhocCalls/{adhocCallId}/recordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les appels ad hoc.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à communications/adhocCalls/{adhocCallId}/recordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) CallRecordings.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CallRecordings.Read.All

Exemple : S’abonner aux enregistrements disponibles pour un appel ad hoc particulier à l’aide d’autorisations classiques

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

S’abonner aux enregistrements disponibles pour les réunions en ligne organisées par un utilisateur

Pour obtenir des notifications de modification pour tout enregistrement disponible pour toute réunion en ligne organisée par un utilisateur spécifique, abonnez-vous à users/{userId}/onlineMeetings/getAllRecordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les onlineMeetings planifiés.

Remarque

Actuellement, cet abonnement ne prend pas en charge les réunions de canal privé.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à users/{userId}/onlineMeetings/getAllRecordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) OnlineMeetingRecording.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingRecording.Read.All

S’abonner aux enregistrements disponibles pour un appel ad hoc où un utilisateur spécifique lance la transcription

Pour obtenir des notifications de modification pour tout enregistrement disponible pour tout appel ad hoc où un utilisateur spécifique lance la transcription, abonnez-vous à users/{userId}/adhocCalls/getAllRecordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les appels ad hoc.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à users/{userId}/adhocCalls/getAllRecordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) CallRecordings.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CallRecordings.Read.All

Exemple

L’exemple suivant montre comment s’abonner aux enregistrements disponibles pour tout appel ad hoc où un utilisateur spécifique lance la transcription.

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

Abonnez-vous aux enregistrements disponibles pour toute réunion en ligne où une application Teams spécifique est installée

Cette section décrit les méthodes permettant de s’abonner aux enregistrements disponibles pour toute réunion en ligne où une application Teams spécifique est installée.

Pour obtenir des notifications de modification pour tout enregistrement disponible pour toute réunion en ligne où une application Teams spécifique est installée, abonnez-vous à appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Cette ressource prend en charge la fonction y compris les données de ressources dans la notification. Cet abonnement prend en charge les réunions en ligne planifiées , mais pas les réunions de canal.

Remarque

Ce type de ressource est disponible uniquement sur le point de /beta terminaison.

Autorisations

L’une des autorisations suivantes est requise pour s’abonner à appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

Remarque

  • L’autorisation OnlineMeetingRecording.Read.Chat utilise le consentement spécifique à la ressource.
  • Pour vous abonner aux enregistrements disponibles pour toute réunion en ligne où une application Teams spécifique est installée en utilisant uniquement les autorisations de consentement spécifiques à la ressource requises, utilisez le useResourceSpecificConsentBasedAuthorization=true paramètre de requête avec votre chaîne de ressource.

Exemple 1 : S’abonner aux enregistrements disponibles pour toute réunion en ligne où une application Teams spécifique est installée à l’aide des autorisations classiques requises

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

Charges utiles de notification

Selon votre abonnement, vous pouvez obtenir la notification avec ou sans données de ressource. L’abonnement aux données de ressources vous permet d’obtenir la transcription ou d’enregistrer des métadonnées avec la notification.

Notifications avec des données de ressources pour les transcriptions

Pour les notifications avec des données de ressource, la charge utile se présente comme suit. Cette charge utile concerne une transcription disponible pour une réunion en ligne. Pour les appels ad hoc, meetingId est null.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

Pour les réunions en ligne

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

Pour les appels ad hoc

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

Notifications déchiffrées pour les transcriptions avec des données de ressources

La charge utile de la notification déchiffrée se présente comme suit. La charge utile est conforme au schéma de transcription . La charge utile est similaire à celles retournées par les opérations GET.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

Pour les réunions en ligne

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

Pour les appels ad hoc

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

Notifications avec des données de ressources pour les enregistrements

Pour les notifications avec des données de ressource, la charge utile se présente comme suit.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

Pour les réunions en ligne

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

Pour les appels ad hoc

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

Notifications déchiffrées pour les enregistrements avec des données de ressources

La charge utile de la notification déchiffrée se présente comme suit. La charge utile est conforme au schéma d’enregistrement . La charge utile est similaire à celles retournées par les opérations GET.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

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

Notifications sans les données de ressource

Les notifications sans données de ressource vous donnent l’ID de ressource pour effectuer des appels GET afin d’obtenir la transcription ou l’enregistrement. Les abonnements aux notifications sans données de ressource ne nécessitent pas de certificat de chiffrement (car les données de ressource réelles ne sont pas envoyées).

Pour les notifications sans données de ressource, la charge utile se présente comme suit.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

Pour les transcriptions de réunion en ligne

{
  "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...')"
  }
}

Pour les transcriptions d’appel ad hoc

Pour les notifications sans données de ressource, la charge utile se présente comme suit. Cette charge utile concerne une transcription disponible pour un appel ad hoc. Pour les appels ad hoc, meetingId est null.

{
  "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...')"
  }
}

Pour les notifications sans données de ressource, la charge utile se présente comme suit.

Remarque

L’objet de charge utile présenté ici est raccourci pour plus de lisibilité.

Pour les enregistrements de réunion en ligne

{
  "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...')"
  }
}

Pour les enregistrements d’appels ad hoc

{
"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...')"
  }
}

Les propriétés resource et @odata.id peuvent être utilisées pour appeler Microsoft Graph afin d’obtenir la transcription ou l’enregistrement.

Contenu connexe

  • Last updated on