名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
attendanceRecord オブジェクトとそのプロパティの一覧を取得します。
ヒント
出席レコードを取得するより便利な方法は、 expand クエリ オプションを使用して、出席レポートに沿って取得することです。 例と詳細については、「 出席レポートを取得する」を参照してください。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | OnlineMeetingArtifact.Read.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | OnlineMeetingArtifact.Read.All | OnlineMeetingArtifact.Read.Chat |
この API のアプリケーションアクセス許可を使用するには、テナント管理者がアプリケーション アクセス ポリシーを作成し、ユーザーに付与する必要があります。 これにより、ポリシーで構成されたアプリが、そのユーザーに代わってオンライン会議やオンライン会議成果物 (要求パスで指定されたユーザー ID) を取得することを承認します。 詳細については、「アプリケーションがユーザーに代わってオンライン会議にアクセスすることを許可する」を参照してください。
HTTP 要求
委任された (/me) とアプリ (/users/{userId}) アクセス許可を持つ出席レポートの出席記録を取得するには:
GET /me/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
GET /users/{userId}/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
委任されたアクセス許可とアプリケーションのアクセス許可を使用してウェビナー セッションの出席レポートから出席レコードを取得するには:
GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}/attendanceRecords
委任されたアクセス許可とアプリケーションのアクセス許可を使用して、タウン ホール セッションの出席レポートから出席レコードを取得するには:
GET /solutions/virtualEvents/townhalls/{townhallId}/sessions/{sessionId}/attendanceReports/{reportId}/attendanceRecords
ヒント
- userId は、ユーザー管理ページのユーザー Microsoft Entra 管理センター >オブジェクト ID です。 詳細については、「アプリケーションがユーザーに代わってオンライン会議にアクセスすることを許可する」を参照してください。
-
meetingIdは、onlineMeeting オブジェクトの ID です。 -
reportIdは meetingAttendanceReport オブジェクトの ID です。 -
webinarIdは virtualEventWebinar オブジェクトの ID です。 -
sessionIdは virtualEventSession オブジェクトのID です。 -
townhallIdは virtualEventTownhall オブジェクトの ID です。 - この API にアクセスできるのは、ウェビナーまたはタウンホールの開催者または共同組織のみです。
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと応答本文の attendanceRecord オブジェクトのコレクションを返します。
注:
タウン ホールの出席レコードは、現在登録をサポートしていないため、外部登録情報や登録 ID は返されません。
例
例 1: 出席レコードを一覧表示する
要求
GET https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"emailAddress": "frederick.cormier@contoso.com",
"totalAttendanceInSeconds": 322,
"role": "Organizer",
"registrantId": 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,
"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
}
]
}
]
}
例 2: Azure Communication Services ユーザーを含む出席レコードを一覧表示する
要求
GET https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "00000012-518d-e776-71d3-44482200c7c4",
"emailAddress": "",
"totalAttendanceInSeconds": 274,
"role": "Presenter",
"registrantId": null,
"identity": {
"@odata.type": "#microsoft.graph.azureCommunicationServicesUserIdentity",
"id": "8:acs:0c6204c3-70b6-4981-9f2c-5194ced1cdd1_00000012-518d-e776-71d3-44482200c7c3",
"displayName": "Misty Croft",
"azureCommunicationServicesResourceId": "0c6204c3-70b6-4981-9f2c-5194ced1cdd1"
},
"attendanceIntervals": [
{
"joinDateTime": "2022-06-29T22:54:43.656285Z",
"leaveDateTime": "2022-06-29T22:59:18.5180137Z",
"durationInSeconds": 274
}
]
},
{
"id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e7",
"emailAddress": "RayBonilla@contoso.com",
"totalAttendanceInSeconds": 209,
"role": "Presenter",
"registrantId": null,
"identity": {
"@odata.type": "#microsoft.graph.communicationsUserIdentity",
"id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e7",
"displayName": "Raymond Bonilla",
"tenantId": "160eec3a-e45f-488b-b127-3dd106c48843"
},
"attendanceIntervals": [
{
"joinDateTime": "2022-06-29T22:55:49.1084865Z",
"leaveDateTime": "2022-06-29T22:59:18.5180137Z",
"durationInSeconds": 209
}
]
}
]
}
例 3: ウェビナー セッションの出席レポートの出席レコードを一覧表示する
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}/attendancerecords
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#solutions/virtualEvents/webinars('336f94f4-3a81-5130-43e9-88f3-fcb3582cde37')/sessions('a0f934c324b7785c')/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,
"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"
}
}
]
}
例 4: タウン ホール セッションの出席レポートの出席レコードを一覧表示する
次の例は、タウン ホール セッションの出席レポートの出席レコードの一覧を取得する方法を示しています。
要求
次の例は要求を示しています。
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/2c2454-7613-4d6e-9c7c-4c8/attendanceRecords
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#solutions/virtualEvents/townhalls('336f94f4-3a81-5130-43e9-88f3-fcb3582cde37')/sessions('a0f934c324b7785c')/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,
"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
}
]
}
]
}