Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
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 | OnlineMeetingArtifact.Read.Chat |
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 einer Onlinebesprechung 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 den Anwesenheitsbericht der letzten Sitzung einer Onlinebesprechung mit delegierter (/me) und App-Berechtigung (/users/{userId}) ab:
GET /me/onlineMeetings/{meetingId}/meetingAttendanceReport
GET /users/{userId}/onlineMeetings/{meetingId}/meetingAttendanceReport
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
- userId ist die Objekt-ID eines Benutzers auf Microsoft Entra Admin Center > Benutzerverwaltungsseite. Weitere Informationen finden Sie unter Zulassen, dass Anwendungen im Namen eines Benutzers auf Onlinebesprechungen zugreifen können.
-
meetingIdist die ID eines onlineMeeting-Objekts . -
reportIdist die ID eines meetingAttendanceReport-Objekts . -
webinarIdist die ID eines virtualEventWebinar-Objekts . -
sessionIdist die ID eines virtualEventSession-Objekts . -
townhallIdist die ID eines virtualEventTownhall-Objekts . - Nur der Webinar-, Rathausorganisator oder Co-Organisator kann auf diese API zugreifen.
Achtung
- Der
/meetingAttendanceReport-Pfad ist veraltet. Verwenden Sie in Zukunft den/attendanceReportsPfad, um Anwesenheitsberichte für eine Onlinebesprechung abzurufen. - Der
/meetingAttendanceReportPfad bleibt aus Gründen der Abwärtskompatibilität in der Betaversion. Um jedoch die gleiche Antwort zu erhalten, müssen Sie den$expandAbfrageparameter hinzufügen. Weitere Informationen finden Sie im Abschnitt Optionale Abfrageparameter . - 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 mit Anwesenheitsdatensätzen für eine Onlinebesprechung mit delegierter Berechtigung inline abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/attendanceReports/2c2c2454-7613-4d6e-9c7c-4cf7a6cdce89?$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/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
}
]
}
]
}
Beispiel 2: Abrufen des aktuellen Anwesenheitsberichts für eine Onlinebesprechung
Das folgende Beispiel zeigt eine Anforderung zum Abrufen eines Besprechungsteilnahmeberichts für die letzte Sitzung einer Onlinebesprechung.
Anforderung
Das folgende Beispiel zeigt eine Anforderung, die delegierte Berechtigung verwendet.
GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy/meetingAttendanceReport
Die folgende Anforderung verwendet die Anwendungsberechtigung.
GET https://graph.microsoft.com/beta/users/dc74d9bb-6afe-433d-8eaa-e39d80d3a647/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy/meetingAttendanceReport
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/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
}
Beispiel 3: 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 können Sie zum Abrufen von attendanceRecords in Line die $expand=attendanceRecords Abfrageoption verwenden, wie in Beispiel 1 gezeigt.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
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
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/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"
}
]
}
Beispiel 4: 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/beta/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/beta/$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"
}
]
}