Freigeben über


Abrufen von meetingAttendanceReport

Namespace: microsoft.graph

Rufen Sie den meetingAttendanceReport für ein onlineMeeting oder ein virtualEvent ab. Wenn eine Onlinebesprechung endet, wird ein Anwesenheitsbericht für diese Sitzung generiert.

Warnung

Diese Methode unterstützt keine Kanalbesprechungen.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetingArtifact.Read.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application OnlineMeetingArtifact.Read.All Nicht verfügbar.

Um die Anwendungsberechtigung für diese API zu verwenden, müssen Mandantenadministratoren eine Anwendungszugriffsrichtlinie erstellen und sie einem Benutzer gewähren. Das Gewähren einer Anwendungszugriffsrichtlinie für den Benutzer autorisiert die in der Richtlinie konfigurierte App zum Abrufen von Onlinebesprechungen und/oder Onlinebesprechungsartefakten im Namen dieses Benutzers (mit der im Anforderungspfad angegebenen Benutzer-ID). Weitere Informationen finden Sie unter Zulassen, dass Anwendungen im Namen eines Benutzers auf Onlinebesprechungen zugreifen können.

HTTP-Anforderung

So rufen Sie einen Anwesenheitsbericht nach ID mit delegierter (/me) und App-Berechtigung (/users/{userId}) ab:

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

So rufen Sie einen Anwesenheitsbericht für eine Webinarsitzung nach ID mit delegierter Und App-Berechtigung ab:

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

So rufen Sie einen Anwesenheitsbericht nach ID für eine Sitzung im Rathaus mit delegierten Berechtigungen und Anwendungsberechtigungen ab:

GET /solutions/virtualEvents/townhalls/{townhallId}/sessions/{sessionId}/attendanceReports/{reportId}

Tipp

Achtung

  • Der /meetingAttendanceReport-Pfad ist veraltet. Verwenden Sie in Zukunft den /attendanceReports Pfad, um Anwesenheitsberichte für eine Onlinebesprechung abzurufen.
  • Die attendanceRecords-Eigenschaft gibt keine Informationen zu einem Gruppenraum zurück.

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Tipp

Die attendanceRecords-Eigenschaft stellt Teilnehmerdaten bereit. Es handelt sich um eine Navigationseigenschaft, die standardmäßig nicht zurückgegeben wird. Verwenden Sie zum Abrufen von attendanceRecords die API Zum Auflisten von Anwesenheitsdatensätzen . Verwenden Sie die $expand=attendanceRecords Abfrageoption, wie in Beispiel 1 gezeigt, um attendanceRecords in Zeile abzurufen.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein meetingAttendanceReport-Objekt im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Abrufen des Anwesenheitsberichts mit Anwesenheitsdatensätzen für eine Onlinebesprechung nach ID

Das folgende Beispiel zeigt, wie Sie den Anwesenheitsbericht für eine Onlinebesprechung mit delegierter Berechtigung abrufen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

Beispiel 2: Abrufen des Anwesenheitsberichts für eine Webinarsitzung nach ID

Das folgende Beispiel zeigt, wie Sie den Anwesenheitsbericht für eine Webinarsitzung basierend auf seiner ID abrufen.

Tipp

Die attendanceRecords-Eigenschaft stellt Teilnehmerdaten bereit. Es handelt sich um eine Navigationseigenschaft, die standardmäßig nicht zurückgegeben wird. Verwenden Sie zum Abrufen von attendanceRecords die API Zum Auflisten von Anwesenheitsdatensätzen . Alternativ zum Abrufen von attendanceRecords in Zeile verwenden Sie die $expand=attendanceRecords Abfrageoption, wie in Beispiel 1 gezeigt.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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",
  "externalEventInformation": [
    {
      "applicationId": "67a527ba-ef0e-4ba2-88b6-4fa5e9711757",
      "externalEventId": "myExternalEventId"
    }
  ]
}

Beispiel 3: Abrufen des Anwesenheitsberichts für eine Sitzung im Rathaus nach ID

Das folgende Beispiel zeigt, wie Sie den Anwesenheitsbericht für eine Sitzung im Rathaus basierend auf ihrer ID abrufen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/f8ce2a5f-0e6a-4186-aa90-1f64bc023566@5466a424-aadf-425c-9b24-034ca28d4bdd/sessions/8d62dd52-4dff-4c75-96a9-f905cc3ff942/attendanceReports/b76965d4-0763-496e-9980-b323c5f3aa3b

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#solutions/virtualEvents/townhalls('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"
    }
  ]
}