callRecording: delta
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Obtenga un conjunto de recursos callRecording agregados para las instancias de onlineMeeting organizadas por el usuario especificado.
La consulta delta admite tanto la sincronización completa que obtiene todas las grabaciones de reuniones en línea organizadas por el usuario como la sincronización incremental que obtiene las grabaciones agregadas desde la última sincronización. Normalmente, realizaría una sincronización completa inicial y, a continuación, obtendría cambios incrementales en esa vista de grabación periódicamente.
Una solicitud GET con la función delta devuelve uno de los tokens siguientes:
- Un
@odata.nextLink
(que contiene una dirección URL con una llamada de función delta y unskipToken
), - Un
@odata.deltaLink
(que contiene una dirección URL con una llamada de función delta y undeltaToken
).
Los tokens de estado son opacos para el cliente. Para continuar con una ronda de seguimiento de cambios, copie y aplique la @odata.nextLink
dirección URL o @odata.deltaLink
devuelta desde la última solicitud GET a la siguiente llamada de función delta para esa misma vista de grabación. Un @odata.deltaLink
devuelto en una respuesta significa que la ronda actual de seguimiento de cambios está completa. Puede guardar y usar la @odata.deltaLink
dirección URL al iniciar la siguiente ronda de sincronización para obtener las nuevas grabaciones agregadas después de adquirir @odata.deltaLink
.
Para obtener más información, vea la documentación de la consulta delta.
Problemas conocidos
Los siguientes problemas conocidos están asociados a esta API:
-
Using the
$top
query parameter might not return the @odata.nextLink. - Es posible que las direcciones URL de transcripción no incluyan ningún contenido.
- Las grabaciones no se exportan para las reuniones que no tienen activada la transcripción.
- Las consultas delta pueden devolver artefactos antiguos cuando las reuniones tienen cambios no relacionados.
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | No admitida. | No admitida. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | OnlineMeetingRecording.Read.All | No disponible. |
Solicitud HTTP
GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta
Nota: Si no pasa el parámetro de función meetingOrganizerUserId, se produce un error en la solicitud.
Parámetros de consulta
El seguimiento de los cambios en las grabaciones de llamadas genera una ronda de una o varias llamadas de función delta . Si usa cualquier parámetro de consulta (distinto de $deltatoken
y $skiptoken
), debe especificarlo en la solicitud delta inicial. Microsoft Graph codifica automáticamente cualquier parámetro especificado en la parte del token de la URL @odata.nextLink
o @odata.deltaLink
proporcionada en la respuesta.
En solicitudes posteriores, copie y aplique la dirección URL @odata.nextLink
o @odata.deltaLink
de la respuesta anterior, dado que la dirección URL ya incluye los parámetros codificados.
Parámetro de consulta | Tipo | Descripción |
---|---|---|
$deltatoken |
string |
Token de estado que se devuelve en la dirección URL @odata.deltaLink de la llamada de función delta anterior. Indica la finalización de esa ronda de seguimiento de cambios. Guarde y aplique toda la dirección URL @odata.deltaLink , incluido este token, en la primera solicitud de la siguiente ronda de seguimiento de cambios de la colección. |
$skiptoken |
string |
Token de estado que se devuelve en la dirección URL de @odata.nextLink de la llamada de función delta. Indica que debe realizarse el seguimiento de más cambios. |
$top |
integer | Permite al autor de la llamada especificar el número máximo de objetos por página. |
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y una colección de objetos callRecording en el cuerpo de la respuesta. La respuesta también incluye una @odata.nextLink
dirección URL o una @odata.deltaLink
dirección URL.
Ejemplos
Ejemplo 1: Ronda inicial de sincronización
En el ejemplo siguiente se muestra una serie de tres solicitudes para sincronizar las grabaciones de llamadas disponibles para todas las reuniones en línea organizadas por el usuario.
- Paso 1: solicitud inicial y respuesta
- Paso 2: segunda solicitud y respuesta
- Paso 3: tercera solicitud y respuesta final
Vea también lo que hará en la siguiente ronda para obtener más grabaciones.
Solicitud inicial
En este ejemplo, las grabaciones de llamadas se sincronizan por primera vez, por lo que la solicitud de sincronización inicial no incluye ningún token de estado. Esta ronda devuelve todas las grabaciones disponibles en ese momento.
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
Respuesta inicial
La respuesta incluye dos grabaciones de llamadas y un @odata.nextLink
encabezado de respuesta con .skipToken
La @odata.nextLink
dirección URL indica que hay más grabaciones de llamadas que recuperar.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
"@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken1}",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.callRecording",
"id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
"meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
"createdDateTime": "2023-12-02T06:59:34.7411768Z",
"recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
}
}
}
]
}
Segunda solicitud
La segunda solicitud especifica la dirección URL @odata.nextLink
devuelta de la respuesta anterior. Observe que ya no tiene que especificar los mismos parámetros de consulta que en la solicitud inicial, ya que en skipToken
la @odata.nextLink
dirección URL los codifica e incluye.
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
$skiptoken={skipToken1}
Segunda respuesta
La segunda respuesta devuelve una o varias grabaciones de llamadas siguientes y una @odata.nextLink
propiedad con , skipToken
que indica que hay más grabaciones.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
"@odata.nextLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.callRecording",
"id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
"meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
"createdDateTime": "2023-12-02T06:59:34.7411768Z",
"recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
}
}
}
]
}
Tercera solicitud
La tercera solicitud continúa usando el último @odata.nextLink
devuelto desde la última solicitud de sincronización.
GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}
Tercera y última respuesta para la ronda
La tercera respuesta devuelve las únicas grabaciones restantes y una @odata.deltaLink
propiedad con , deltaToken
que indica que se devuelven todas las grabaciones. Guarde y use la @odata.deltaLink
dirección URL para consultar cualquier nueva grabación que se agregue a partir de este momento.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.callRecording",
"id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
"meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
"createdDateTime": "2023-12-02T06:59:34.7411768Z",
"recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
}
}
}
]
}
Ejemplo 2: Siguiente ronda para obtener más grabaciones
Con desde @odata.deltaLink
la última solicitud de la última ronda, solo puede obtener las grabaciones agregadas desde que @odata.deltaLink
se adquirió.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken2}",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.callRecording",
"id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
"meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
"createdDateTime": "2023-12-02T06:59:34.7411768Z",
"recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
}
}
}
]
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de