attendanceRecords を一覧表示する
名前空間: 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 | 注意事項なし。 |
この API のアプリケーションアクセス許可を使用するには、テナント管理者がアプリケーション アクセス ポリシーを作成し、ユーザーに付与する必要があります。 これにより、ポリシーで構成されたアプリが、そのユーザーに代わってオンライン会議やオンライン会議成果物 (要求パスで指定されたユーザー ID) を取得することを承認します。 詳細については、「アプリケーションがユーザーに代わってオンライン会議にアクセスすることを許可する」を参照してください。
HTTP 要求
委任された () とアプリ/users/{userId}
(/me
) のアクセス許可を持つ出席レポートの出席記録を取得するには:
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
- userId は、ユーザー管理ページのユーザー Microsoft Entra 管理センター>オブジェクト ID です。 詳細については、「アプリケーションがユーザーに代わってオンライン会議にアクセスすることを許可する」を参照してください。
meetingId
は、onlineMeeting オブジェクトの ID です。reportId
は meetingAttendanceReport オブジェクトの ID です。webinarId
は virtualEventWebinar オブジェクトの ID です。sessionId
は virtualEventSession オブジェクトのID です。
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK
応答コードと応答本文の attendanceRecord オブジェクトのコレクションを返します。
例
例 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,
"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
}
]
}
]
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示