Obtener meetingAttendanceReport
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 meetingAttendanceReport para un evento onlineMeeting o virtualEvent. Cuando finaliza una reunión en línea, se genera un informe de asistencia para esa sesión.
Advertencia
Este método no admite reuniones de canal.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
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) | OnlineMeetingArtifact.Read.All | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | OnlineMeetingArtifact.Read.All | No disponible. |
Para usar el permiso de aplicación para esta API, los administradores de inquilinos deben crear una directiva de acceso a la aplicación y concederla a un usuario. La concesión de una directiva de acceso de aplicación al usuario autoriza a la aplicación configurada en la directiva a capturar reuniones en línea o artefactos de reunión en línea en nombre de ese usuario (con el identificador de usuario especificado en la ruta de acceso de la solicitud). Para obtener más información, consulte Permitir que las aplicaciones accedan a reuniones en línea en nombre de un usuario.
Solicitud HTTP
Para obtener un informe de asistencia de una reunión en línea por identificador con permiso delegado (/me
) y de aplicación (/users/{userId}
):
GET /me/onlineMeetings/{meetingId}/attendanceReports/{reportId}
GET /users/{userId}/onlineMeetings/{meetingId}/attendanceReports/{reportId}
Para obtener el informe de asistencia de la última sesión de una reunión en línea con permiso delegado (/me
) y de aplicación (/users/{userId}
):
GET /me/onlineMeetings/{meetingId}/meetingAttendanceReport
GET /users/{userId}/onlineMeetings/{meetingId}/meetingAttendanceReport
Para obtener un informe de asistencia para una sesión de seminario web por identificador con permiso delegado y de aplicación:
GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}
Sugerencia
- userId es el identificador de objeto de un usuario en la página de administración de usuarios del Centro > de administración de Microsoft Entra. Para obtener más información, consulte Permitir que las aplicaciones accedan a reuniones en línea en nombre de un usuario.
-
meetingId
es el identificador de un objeto onlineMeeting . -
reportId
es el identificador de un objeto meetingAttendanceReport . -
webinarId
es el identificador de un objeto virtualEventWebinar . -
sessionId
es el identificador de un objeto virtualEventSession . - Solo el organizador de reuniones o seminarios web o el coorganizador pueden acceder a esta API.
Precaución
- La ruta de acceso
/meetingAttendanceReport
está en desuso. En el futuro, use la/attendanceReports
ruta de acceso para recuperar los informes de asistencia de una reunión en línea. - La
/meetingAttendanceReport
ruta de acceso permanecerá en versión beta por compatibilidad con versiones anteriores. Sin embargo, para obtener la misma respuesta, debe agregar la opción deexpand
consulta. Para obtener más información, consulte la sección Parámetros de consulta opcionales . - La propiedad attendanceRecords no devuelve información sobre una sala de interrupción.
Parámetros de consulta opcionales
Este método admite los parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.
Sugerencia
La propiedad attendanceRecords proporciona datos de participantes. Es una propiedad de navegación que no se devuelve de forma predeterminada. Para recuperar attendanceRecords, use la API List attendance records . Para recuperar attendanceRecords en línea, use la opción de $expand=attendanceRecords
consulta, como se muestra en el ejemplo 1.
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto meetingAttendanceReport en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Obtención del informe de asistencia con registros de asistencia para una reunión en línea por identificador
En el ejemplo siguiente se muestra cómo obtener el informe de asistencia con registros de asistencia alineados para una reunión en línea con permiso delegado.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/attendanceReports/2c2c2454-7613-4d6e-9c7c-4cf7a6cdce89?$expand=attendanceRecords
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#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/attendanceReports('c9b6db1c-d5eb-427d-a5c0-20088d9b22d7')",
"id": "c9b6db1c-d5eb-427d-a5c0-20088d9b22d7",
"totalParticipantCount": 1,
"meetingStartDateTime": "2021-10-05T04:38:23.945Z",
"meetingEndDateTime": "2021-10-05T04:43:49.77Z",
"attendanceRecords": [
{
"emailAddress": "(email address)",
"totalAttendanceInSeconds": 1152,
"role": "Presenter",
"identity": {
"id": "(redacted)",
"displayName": "(redacted)",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-03-16T18:59:52.2782182Z",
"leaveDateTime": "2021-03-16T19:06:47.7218491Z",
"durationInSeconds": 415
},
{
"joinDateTime": "2021-03-16T19:09:23.9834702Z",
"leaveDateTime": "2021-03-16T19:16:31.1381195Z",
"durationInSeconds": 427
},
{
"joinDateTime": "2021-03-16T19:20:27.7094382Z",
"leaveDateTime": "2021-03-16T19:25:37.7121956Z",
"durationInSeconds": 310
}
]
}
]
}
Ejemplo 2: Obtención del informe de asistencia más reciente para una reunión en línea
En el ejemplo siguiente se muestra una solicitud para obtener un informe de asistencia a reuniones para la sesión más reciente de una reunión en línea.
Solicitud
En el ejemplo siguiente se muestra una solicitud que usa el permiso delegado.
GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy/meetingAttendanceReport
En la solicitud siguiente se usa el permiso de aplicación.
GET https://graph.microsoft.com/beta/users/dc74d9bb-6afe-433d-8eaa-e39d80d3a647/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy/meetingAttendanceReport
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#users('dc74d9bb-6afe-433d-8eaa-e39d80d3a647')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy')/meetingAttendanceReport/$entity",
"attendanceRecords": [
{
"emailAddress": "email address",
"totalAttendanceInSeconds": 1558,
"role": "Organizer",
"identity": {
"id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
"displayName": "(redacted)",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-03-16T18:59:46.598956Z",
"leaveDateTime": "2021-03-16T19:25:45.4473057Z",
"durationInSeconds": 1558
}
]
},
{
"emailAddress": "email address",
"totalAttendanceInSeconds": 1152,
"role": "Presenter",
"identity": {
"id": "(redacted)",
"displayName": "(redacted)",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-03-16T18:59:52.2782182Z",
"leaveDateTime": "2021-03-16T19:06:47.7218491Z",
"durationInSeconds": 415
},
{
"joinDateTime": "2021-03-16T19:09:23.9834702Z",
"leaveDateTime": "2021-03-16T19:16:31.1381195Z",
"durationInSeconds": 427
},
{
"joinDateTime": "2021-03-16T19:20:27.7094382Z",
"leaveDateTime": "2021-03-16T19:25:37.7121956Z",
"durationInSeconds": 310
}
]
}
],
"totalParticipantCount": 2
}
Ejemplo 3: Obtención del informe de asistencia de una sesión de seminario web por identificador
En el ejemplo siguiente se muestra cómo obtener el informe de asistencia de una sesión de seminario web en función de su identificador.
Sugerencia
La propiedad attendanceRecords proporciona datos de participantes. Es una propiedad de navegación que no se devuelve de forma predeterminada. Para recuperar attendanceRecords, use la API List attendance records . Como alternativa, para recuperar attendanceRecords en línea, use la opción de $expand=attendanceRecords
consulta, como se muestra en el ejemplo 1.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f8ce2a5f-0e6a-4186-aa90-1f64bc023566@5466a424-aadf-425c-9b24-034ca28d4bdd/sessions/8d62dd52-4dff-4c75-96a9-f905cc3ff942/attendanceReports/b76965d4-0763-496e-9980-b323c5f3aa3b
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#solutions/virtualEvents/webinars('f8ce2a5f-0e6a-4186-aa90-1f64bc023566@5466a424-aadf-425c-9b24-034ca28d4bdd')/sessions('8d62dd52-4dff-4c75-96a9-f905cc3ff942')/attendanceReports('b76965d4-0763-496e-9980-b323c5f3aa3b')",
"id": "b76965d4-0763-496e-9980-b323c5f3aa3b",
"totalParticipantCount": 2,
"meetingStartDateTime": "2021-10-04T23:13:31.658Z",
"meetingEndDateTime": "2021-10-04T23:18:57.563Z",
"externalEventInformation": [
{
"applicationId" : "67a527ba-ef0e-4ba2-88b6-4fa5e9711757",
"externalEventId": "myExternalEventId"
}
]
}