フィードバック 編集

meetingAttendanceReport を取得する

  • [アーティクル]

名前空間: microsoft.graph

onlineMeeting の meetingAttendanceReport を取得します。 オンライン会議が終了するたびに、そのセッションの出席レポートが生成されます。

警告

このメソッドは、チャネル会議をサポートしていません。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) OnlineMeetingArtifact.Read.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション OnlineMeetingArtifact.Read.All

この API のアプリケーションアクセス許可を使用するには、テナント管理者がアプリケーション アクセス ポリシーを作成し、それをユーザーに付与する必要があります。 これにより、ポリシーで構成されたアプリが、そのユーザーに代わってオンライン会議やオンライン会議成果物をフェッチすることを承認します (要求パスにユーザー ID が指定されています)。 詳細については、「 アプリケーションがユーザーに代わってオンライン会議にアクセスすることを許可する」を参照してください。

HTTP 要求

委任された () アクセス許可とアプリ (/me``/users/{userId}) アクセス許可を持つ ID で出席レポートを取得するには、

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

ヒント

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

ヒント

attendanceRecords プロパティは、既定では返されないナビゲーション プロパティです。 行内 の attendanceRecords を 取得するには、例に$expand=attendanceRecords示すようにクエリ オプションを使用します。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと応答本文の meetingAttendanceReport オブジェクトを返します。

例

次の例は、委任されたアクセス許可を持つオンライン会議の出席レポートを取得する方法を示しています。

要求

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

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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