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
Ruft eine Liste der attendanceRecord-Objekte und deren Eigenschaften ab.
Tipp
Eine bequemere Möglichkeit zum Abrufen von Anwesenheitsdaten besteht darin, sie mithilfe der expand Abfrageoption mit einem Anwesenheitsbericht in Einklang zu bringen. Ein Beispiel und weitere Details finden Sie unter Get meetingAttendanceReport.For an example and more details, see Get meetingAttendanceReport.
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. Dadurch wird die in der Richtlinie konfigurierte App zum Abrufen von Onlinebesprechungen und/oder Onlinebesprechungsartefakten im Namen dieses Benutzers autorisiert (mit der im Anforderungspfad angegebenen Benutzer-ID). Weitere Informationen finden Sie unter Anwendungen den Zugriff auf Onlinebesprechungen im Namen eines Benutzers erlauben.
Hinweis
Die OnlineMeetingArtifact.Read.Chat Berechtigung verwendet die ressourcenspezifische Zustimmung.
HTTP-Anforderung
So rufen Sie Anwesenheitsaufzeichnungen eines Anwesenheitsberichts mit delegierter (/me) und App-Berechtigung (/users/{userId}) ab:
GET /me/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
GET /users/{userId}/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
So rufen Sie Anwesenheitsdatensätze aus dem Anwesenheitsbericht für eine Webinarsitzung mit delegierten Berechtigungen und Anwendungsberechtigungen ab:
GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}/attendanceRecords
So rufen Sie Anwesenheitsaufzeichnungen aus dem Anwesenheitsbericht für eine Sitzung im Rathaus mit delegierten Berechtigungen und Anwendungsberechtigungen ab:
GET /solutions/virtualEvents/townhalls/{townhallId}/sessions/{sessionId}/attendanceReports/{reportId}/attendanceRecords
Tipp
- userId ist die Objekt-ID eines Benutzers auf Microsoft Entra Admin Center > Benutzerverwaltungsseite. Weitere Informationen finden Sie unter Anwendungen den Zugriff auf Onlinebesprechungen im Namen eines Benutzers erlauben.
-
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.
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.
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 eine Auflistung von attendanceRecord-Objekten im Antworttext zurückgegeben.
Beispiele
Beispiel 1: Auflisten von Anwesenheitsdatensätzen
Anforderung
GET https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/attendanceReports/c9b6db1c-d5eb-427d-a5c0-20088d9b22d7/attendanceRecords
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"emailAddress": "frederick.cormier@contoso.com",
"totalAttendanceInSeconds": 322,
"role": "Organizer",
"identity": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4623",
"displayName": "Frederick Cormier",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-05T04:38:27.6027225Z",
"leaveDateTime": "2021-10-05T04:43:49.7702391Z",
"durationInSeconds": 322
}
]
},
{
"emailAddress": "lisa.adkins@contoso.com",
"totalAttendanceInSeconds": 314,
"role": "Presenter",
"identity": {
"id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e9",
"displayName": "Lisa Adkins",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-04T23:13:43.3776519Z",
"leaveDateTime": "2021-10-04T23:18:57.5639338Z",
"durationInSeconds": 314
}
]
}
]
}
Beispiel 2: Auflisten von Anwesenheitsdatensätzen für den Anwesenheitsbericht einer Webinarsitzung
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/336f94f4-3a81-5130-43e9-88f3-fcb3582cde37/sessions/8d62dd52-4dff-4c75-96a9-f905cc3ff942/attendanceReports/2c2454-7613-4d6e-9c7c-4c8/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#solutions/virtualEvents/webinars('336f94f4-3a81-5130-43e9-88f3-fcb3582cde37')/sessions('8d62dd52-4dff-4c75-96a9-f905cc3ff942')/attendanceReports('2c2454-7613-4d6e-9c7c-4c8')/attendanceRecords",
"value": [
{
"emailAddress": "frederick.cormier@contoso.com",
"totalAttendanceInSeconds": 322,
"role": "Organizer",
"registrantId": null,
"registrationId": null,
"identity": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4623",
"displayName": "Frederick Cormier",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-05T04:38:27.6027225Z",
"leaveDateTime": "2021-10-05T04:43:49.7702391Z",
"durationInSeconds": 322
}
],
"externalRegistrationInformation": {
"referrer": "Fabrikam",
"registrationId": "myExternalRegistrationId"
}
},
{
"emailAddress": "lisa.adkins@contoso.com",
"totalAttendanceInSeconds": 314,
"role": "Presenter",
"registrantId": null,
"registrationId": null,
"identity": {
"id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e9",
"displayName": "Lisa Adkins",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-04T23:13:43.3776519Z",
"leaveDateTime": "2021-10-04T23:18:57.5639338Z",
"durationInSeconds": 314
}
],
"externalRegistrationInformation": {
"referrer": "Fabrikam",
"registrationId": "anotherExternalRegistrationId"
}
}
]
}
Beispiel 3: Auflisten von Anwesenheitsaufzeichnungen für den Anwesenheitsbericht einer Sitzung im Rathaus
Das folgende Beispiel zeigt, wie Sie eine Liste der Anwesenheitsdatensätze für den Anwesenheitsbericht einer Sitzung im Rathaus abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/f8ce2a5f-0e6a-4186-aa90-1f64bc023566/sessions/8d62dd52-4dff-4c75-96a9-f905cc3ff942/attendanceReports/2c2454-7613-4d6e-9c7c-4c8/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#solutions/virtualEvents/townhalls('8ce2a5f-0e6a-4186-aa90-1f64bc023566')/sessions('8d62dd52-4dff-4c75-96a9-f905cc3ff942')/attendanceReports('2c2454-7613-4d6e-9c7c-4c8')/attendancerecords",
"value": [
{
"emailAddress": "frederick.cormier@contoso.com",
"totalAttendanceInSeconds": 322,
"role": "Organizer",
"registrantId": null,
"registrationId": null,
"identity": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4623",
"displayName": "Frederick Cormier",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-05T04:38:27.6027225Z",
"leaveDateTime": "2021-10-05T04:43:49.7702391Z",
"durationInSeconds": 322
}
]
},
{
"emailAddress": "lisa.adkins@contoso.com",
"totalAttendanceInSeconds": 314,
"role": "Presenter",
"registrantId": null,
"registrationId": null,
"identity": {
"id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e9",
"displayName": "Lisa Adkins",
"tenantId": null
},
"attendanceIntervals": [
{
"joinDateTime": "2021-10-04T23:13:43.3776519Z",
"leaveDateTime": "2021-10-04T23:18:57.5639338Z",
"durationInSeconds": 314
}
]
}
]
}