Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las notificaciones de cambio le permiten suscribirse a los cambios en transcripciones y grabaciones. Puede recibir una notificación cada vez que una transcripción o una grabación estén disponibles después de una reunión en línea o una llamada ad hoc.
En este artículo se describen los escenarios de los recursos de transcripción y grabación . Para obtener más información, consulte Cambiar las notificaciones de los recursos de Microsoft Teams.
Nota:
Si solicita una expiración de suscripciónDateTime que sea superior a 1 hora en el futuro, debe suscribirse a las notificaciones de ciclo de vida incluyendo una propiedad lifecycleNotificationUrl en la solicitud de suscripción. De lo contrario, se produce un error en la solicitud de suscripción con el siguiente mensaje de error: lifecycleNotificationUrl es necesario para la creación de la suscripción en este recurso cuando el valor expirationDateTime supera 1 hora.
Suscribirse a transcripciones disponibles en el nivel de inquilino
En esta sección se describen los métodos para suscribirse a transcripciones disponibles en el nivel de inquilino para reuniones en línea y llamadas ad hoc.
Para reuniones en línea
Para obtener notificaciones de cambios para cualquier transcripción disponible para cualquier reunión en línea en un inquilino, suscríbase a communications/onlineMeetings/getAllTranscripts. Este recurso permite incluir datos de recursos en la notificación. La notificación de una transcripción solo se envía si la suscripción se produce antes de que se inicie la transcripción. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite actualmente reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/onlineMeetings/getAllTranscripts.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingTranscript.Read.All |
Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a transcripciones de reuniones en línea disponibles en el nivel de inquilino.
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}"
}
Para llamadas ad hoc
Para obtener notificaciones de cambios para cualquier transcripción disponible para cualquier llamada ad hoc en un inquilino, suscríbase a communications/adhocCalls/getAllTranscripts. Este recurso permite incluir datos de recursos en la notificación.
Nota:
Este tipo de recurso solo está disponible en el punto de /beta conexión.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/adhocCalls/getAllTranscripts.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | CallTranscripts.Read.All |
Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a transcripciones de llamada ad hoc disponibles en el nivel de inquilino.
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}"
}
Suscribirse a transcripciones disponibles para una reunión en línea determinada
Para obtener notificaciones de cambios para cualquier transcripción disponible para una reunión en línea determinada, suscríbase a communications/onlineMeetings/{onlineMeetingId}/transcripts. Este recurso permite incluir datos de recursos en la notificación. La notificación de una transcripción solo se envía si la suscripción se produce antes de que se inicie la transcripción. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite actualmente reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/onlineMeetings/{onlineMeetingId}/transcripts. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | OnlineMeetingTranscript.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All |
Nota:
- El
OnlineMeetingTranscript.Read.Chatpermiso usa el consentimiento específico del recurso. Este permiso solo se aplica a las reuniones de chat privadas programadas, no a las reuniones de canal. - Para suscribirse a cualquier transcripción disponible para una reunión en línea determinada mediante solo los permisos de consentimiento específicos del recurso necesarios, use el parámetro de consulta con la
useResourceSpecificConsentBasedAuthorization=truecadena de recurso.
Ejemplo 1: Suscribirse a transcripciones disponibles para una reunión en línea determinada mediante permisos clásicos
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}"
}
Ejemplo 2: Suscripción a transcripciones disponibles para una reunión en línea determinada mediante permisos de consentimiento específicos del recurso
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}"
}
Suscribirse a transcripciones disponibles para una llamada ad hoc determinada
Para obtener notificaciones de cambio para cualquier transcripción disponible para una llamada ad hoc determinada, suscríbase a communications/adhocCalls/{adhocCallId}/transcripts.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/adhocCalls/{adhocCallId}/transcripts. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | CallTranscripts.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | No admitida. |
Ejemplo: Suscripción a transcripciones disponibles para una llamada ad hoc determinada mediante permisos clásicos
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}"
}
Suscribirse a transcripciones disponibles para reuniones en línea organizadas por un usuario
Para obtener notificaciones de cambio de cualquier transcripción disponible para cualquier reunión en línea organizada por un usuario específico, suscríbase a users/{userId}/onlineMeetings/getAllTranscripts. Este recurso permite incluir datos de recursos en la notificación. La notificación de una transcripción solo se envía si la suscripción se produce antes de que se inicie la transcripción. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite actualmente reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a users/{userId}/onlineMeetings/getAllTranscripts. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | OnlineMeetingTranscript.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingTranscript.Read.All |
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a transcripciones disponibles para cualquier reunión en línea organizada por un usuario específico.
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}"
}
Suscribirse a transcripciones disponibles para llamadas ad hoc en las que un usuario específico inicia la transcripción
Para obtener notificaciones de cambio de cualquier transcripción disponible para cualquier llamada ad hoc en la que un usuario específico inicie la transcripción, suscríbase a users/{userId}/adhocCalls/getAllTranscripts. Este recurso permite incluir datos de recursos en la notificación. La notificación de una transcripción solo se envía si la suscripción se produce antes de que se inicie la transcripción. Esta suscripción admite llamadas ad hoc.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a users/{userId}/adhocCalls/getAllTranscripts. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | CallTranscripts.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | CallTranscripts.Read.All |
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a transcripciones disponibles para cualquier llamada ad hoc en la que un usuario específico inicie la transcripción.
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}"
}
Suscribirse a transcripciones disponibles para cualquier reunión en línea en la que esté instalada una aplicación específica de Teams
Para obtener notificaciones de cambios para cualquier transcripción disponible para cualquier reunión en línea en la que esté instalada una aplicación específica de Teams, suscríbase a appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Este recurso permite incluir datos de recursos en la notificación. La notificación de una transcripción solo se envía si la suscripción se produce antes de que se inicie la transcripción. Esta suscripción admite las reuniones en línea programadas , pero no las reuniones de canal.
Nota:
Este tipo de recurso solo está disponible en el punto de /beta conexión.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingTranscript.Read.Chat, OnlineMeetingTranscript.Read.All |
Nota:
- El
OnlineMeetingTranscript.Read.Chatpermiso usa el consentimiento específico del recurso. - Para suscribirse a transcripciones disponibles para cualquier reunión en línea en la que se instale una aplicación de Teams específica con solo los permisos de consentimiento específicos del recurso necesarios, use el parámetro de consulta con la
useResourceSpecificConsentBasedAuthorization=truecadena de recurso.
Ejemplo 1: Suscribirse a transcripciones disponibles para cualquier reunión en línea en la que se instala una aplicación específica de Teams mediante permisos clásicos
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}"
}
Ejemplo 2: Suscribirse a transcripciones disponibles para cualquier reunión en línea en la que se instala una aplicación específica de Teams con solo permisos de consentimiento específicos del recurso
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}"
}
Suscribirse a las grabaciones disponibles en el nivel de inquilino
En esta sección se describen los métodos para suscribirse a las grabaciones disponibles en el nivel de inquilino para reuniones en línea y llamadas ad hoc.
Para reuniones en línea
Para obtener notificaciones de cambios para cualquier grabación disponible para cualquier reunión en línea en un inquilino, suscríbase a communications/onlineMeetings/getAllRecordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/onlineMeetings/getAllRecordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingRecording.Read.All |
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a las grabaciones disponibles en el nivel de inquilino para reuniones en línea.
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}"
}
Para llamadas ad hoc
Para obtener notificaciones de cambios para cualquier grabación disponible para cualquier llamada ad hoc en un inquilino, suscríbase a communications/adhocCalls/getAllRecordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite adhocCalls.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/adhocCalls/getAllRecordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | CallRecordings.Read.All |
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a las grabaciones disponibles en el nivel de inquilino.
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}"
}
Suscribirse a las grabaciones disponibles para una reunión en línea determinada
Para obtener notificaciones de cambio de cualquier grabación disponible para una reunión en línea determinada, suscríbase a communications/onlineMeetings/{onlineMeetingId}/recordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite actualmente reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/onlineMeetings/{onlineMeetingId}/recordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | OnlineMeetingRecording.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All |
Nota:
- El
OnlineMeetingRecording.Read.Chatpermiso usa el consentimiento específico del recurso. Este permiso solo se aplica a las reuniones de chat privadas programadas, no a las reuniones de canal. - Para suscribirse a cualquier grabación disponible para una reunión en línea determinada utilizando solo los permisos de consentimiento específicos del recurso necesarios, use el parámetro de consulta con la
useResourceSpecificConsentBasedAuthorization=truecadena de recurso.
Ejemplo 1: Suscribirse a las grabaciones disponibles para una reunión en línea determinada mediante permisos clásicos
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}"
}
Ejemplo 2: Suscribirse a las grabaciones disponibles para una reunión en línea determinada con solo permisos de consentimiento específicos de recursos
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}"
}
Suscribirse a las grabaciones disponibles para una llamada ad hoc determinada
Para obtener notificaciones de cambio de cualquier grabación disponible para una llamada ad hoc determinada, suscríbase a communications/adhocCalls/{adhocCallId}/recordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite llamadas ad hoc.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a communications/adhocCalls/{adhocCallId}/recordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | CallRecordings.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | CallRecordings.Read.All |
Ejemplo: Suscribirse a las grabaciones disponibles para una llamada ad hoc determinada mediante permisos clásicos
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}"
}
Suscribirse a las grabaciones disponibles para las reuniones en línea organizadas por un usuario
Para obtener notificaciones de cambios para cualquier grabación disponible para cualquier reunión en línea organizada por un usuario específico, suscríbase a users/{userId}/onlineMeetings/getAllRecordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite onlineMeetings programada.
Nota:
Esta suscripción no admite actualmente reuniones de canales privados.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a users/{userId}/onlineMeetings/getAllRecordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | OnlineMeetingRecording.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingRecording.Read.All |
Suscribirse a las grabaciones disponibles para llamadas ad hoc en las que un usuario específico inicia la transcripción
Para obtener notificaciones de cambio de cualquier grabación disponible para cualquier llamada ad hoc en la que un usuario específico inicie la transcripción, suscríbase a users/{userId}/adhocCalls/getAllRecordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite llamadas ad hoc.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a users/{userId}/adhocCalls/getAllRecordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | CallRecordings.Read.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | CallRecordings.Read.All |
Ejemplo
En el ejemplo siguiente se muestra cómo suscribirse a las grabaciones disponibles para cualquier llamada ad hoc en la que un usuario específico inicie la transcripción.
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}"
}
Suscribirse a las grabaciones disponibles para cualquier reunión en línea en la que esté instalada una aplicación específica de Teams
En esta sección se describen los métodos para suscribirse a las grabaciones disponibles para cualquier reunión en línea en la que esté instalada una aplicación específica de Teams.
Para obtener notificaciones de cambio de cualquier grabación disponible para cualquier reunión en línea en la que esté instalada una aplicación específica de Teams, suscríbase a appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Este recurso permite incluir datos de recursos en la notificación. Esta suscripción admite las reuniones en línea programadas , pero no las reuniones de canal.
Nota:
Este tipo de recurso solo está disponible en el punto de /beta conexión.
Permissions
Se requiere uno de los permisos siguientes para suscribirse a appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | No admitida. |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All |
Nota:
- El
OnlineMeetingRecording.Read.Chatpermiso usa el consentimiento específico del recurso. - Para suscribirse a las grabaciones disponibles para cualquier reunión en línea en la que se instale una aplicación de Teams específica con solo los permisos de consentimiento específicos del recurso necesarios, use el parámetro de consulta con la
useResourceSpecificConsentBasedAuthorization=truecadena de recurso.
Ejemplo 1: Suscribirse a las grabaciones disponibles para cualquier reunión en línea en la que se instala una aplicación específica de Teams mediante los permisos clásicos necesarios
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}"
}
Ejemplo 2: Suscribirse a las grabaciones disponibles para cualquier reunión en línea en la que se instala una aplicación específica de Teams con solo permisos de consentimiento específicos del recurso
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}"
}
Cargas de notificaciones
En función de la suscripción, puede obtener la notificación con o sin datos de recursos. Suscribirse con datos de recursos le permite obtener la transcripción o registrar metadatos junto con la notificación.
Notificaciones con datos de recursos para transcripciones
Para las notificaciones con datos de recursos, la carga es similar a la siguiente. Esta carga es para una transcripción disponible para una reunión en línea. En el caso de las llamadas ad hoc, meetingId es null.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
Para reuniones en línea
{
"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-->>"
]
}
Para llamadas 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-->>"
]
}
Notificaciones descifradas para transcripciones con datos de recursos
La carga de notificación descifrada es similar a la siguiente. La carga se ajusta al esquema de transcripción . La carga es similar a las devueltas por las operaciones GET.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
Para reuniones en línea
{
"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"
}
}
}
Para llamadas 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"
}
}
}
Notificaciones con datos de recursos para grabaciones
Para las notificaciones con datos de recursos, la carga es similar a la siguiente.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
Para reuniones en línea
{
"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-->>"
]
}
Para llamadas 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-->>"
]
}
Notificaciones descifradas para grabaciones con datos de recursos
La carga de notificación descifrada es similar a la siguiente. La carga se ajusta al esquema de grabación . La carga es similar a las devueltas por las operaciones GET.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
{
"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
}
Notificaciones con datos de recursos
Las notificaciones sin datos de recursos proporcionan el identificador de recurso para realizar llamadas GET para obtener la transcripción o grabación. Las suscripciones para notificaciones sin datos de recursos no requieren un certificado de cifrado (porque los datos de recursos reales no se envían).
Para las notificaciones sin datos de recursos, la carga es similar a la siguiente.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
Para transcripciones de reuniones en línea
{
"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...')"
}
}
Para transcripciones de llamada ad hoc
Para las notificaciones sin datos de recursos, la carga es similar a la siguiente. Esta carga es para una transcripción disponible para una llamada ad hoc. En el caso de las llamadas ad hoc, meetingId es 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...')"
}
}
Para las notificaciones sin datos de recursos, la carga es similar a la siguiente.
Nota:
El objeto de carga que se muestra aquí se ha acortado para mejorar la legibilidad.
Para grabaciones de reuniones en línea
{
"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...')"
}
}
Para grabaciones de llamadas 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...')"
}
}
Las propiedades resource y @odata.id se pueden usar para llamar a Microsoft Graph para obtener la transcripción o grabación.
Contenido relacionado
- Notificaciones de cambios en Microsoft Graph
- Obtener notificaciones para equipos y canales con Microsoft Graph
- Obtención de notificaciones de cambios para los cambios de pertenencia en canales mediante Microsoft Graph
- Obtención de notificaciones de cambios para los cambios de pertenencia en equipos mediante Microsoft Graph
- Obtener notificaciones de cambio de mensajes en canales y chats de Teams con Microsoft Graph
- Obtener notificaciones de cambios para la pertenencia a chats mediante Microsoft Graph
- Introducción a la API de Microsoft Teams
- Cambiar el equipo de notificaciones o el ejemplo de canal de C#
- Ejemplo de Node.js de canal o equipo de notificaciones de cambios