Поделиться через


Get meetingAttendanceReport

Пространство имен: microsoft.graph

Получите meetingAttendanceReport для объекта onlineMeeting или virtualEvent. По завершении собрания по сети создается отчет о посещаемости для этого сеанса.

Предупреждение

Этот метод не поддерживает собрания каналов.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) OnlineMeetingArtifact.Read.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение OnlineMeetingArtifact.Read.All Недоступно.

Чтобы использовать разрешение приложения для этого API, администраторы клиентов должны создать политику доступа к приложениям и предоставить ее пользователю. Предоставление пользователю политики доступа к приложениям разрешает приложению, настроенное в политике, для получения онлайн-собраний и (или) артефактов собраний по сети от имени этого пользователя (с идентификатором пользователя, указанным в пути запроса). Дополнительные сведения см. в разделе Разрешить приложениям доступ к собраниям по сети от имени пользователя.

HTTP-запрос

Чтобы получить отчет о посещаемости по идентификатору с делегированным разрешением (/me) и приложению (/users/{userId}), выполните следующие действия:

GET /me/onlineMeetings/{meetingId}/attendanceReports/{reportId}
GET /users/{userId}/onlineMeetings/{meetingId}/attendanceReports/{reportId}

Чтобы получить отчет о посещаемости сеанса вебинара по идентификатору с делегированными разрешениями и разрешениями приложения:

GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}

Совет

Предостережение

  • Свойство attendanceRecords не возвращает сведения о переговорной комнате.

Необязательные параметры запросов

Этот метод поддерживает параметры запросов OData для настройки отклика.

Совет

Свойство attendanceRecords предоставляет данные участника. Это свойство навигации, которое не возвращается по умолчанию. Чтобы получить данные о посещаемости, используйте API списков записей посещаемости . Чтобы получить данные о посещаемости в строке , используйте $expand=attendanceRecords параметр запроса, как показано в примере 1.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект meetingAttendanceReport в тексте ответа.

Примеры

Пример 1. Получение отчета о посещаемости с записями о посещаемости для онлайн-собрания по идентификатору

В следующем примере показано, как получить отчет о посещаемости собрания по сети с делегированным разрешением.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/attendanceReports/c9b6db1c-d5eb-427d-a5c0-20088d9b22d7?$expand=attendanceRecords

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$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": "frederick.cormier@contoso.com",
      "totalAttendanceInSeconds": 1152,
      "role": "Presenter",
      "identity": {
        "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4623",
        "displayName": "Frederick Cormier",
        "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
        }
      ]
    }
  ]
}

Пример 2. Получение отчета о посещаемости сеанса вебинара по идентификатору

В следующем примере показано, как получить отчет о посещаемости для сеанса вебинара на основе его идентификатора.

Совет

Свойство attendanceRecords предоставляет данные участника. Это свойство навигации, которое не возвращается по умолчанию. Чтобы получить данные о посещаемости, используйте API списков записей посещаемости . Кроме того, чтобы получить данные о посещаемости в строке , используйте $expand=attendanceRecords параметр запроса, как показано в примере 1.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/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

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$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"
}