仮想イベント登録のセッションを一覧表示する
名前空間: microsoft.graph
ウェビナーで登録者が登録した セッション の概要の一覧を取得 します。 セッションの概要には、仮想イベント セッションの endDateTime、 id、 joinWebUrl、 startDateTime、 subject のみが含まれます。 セッション プロパティの残りの部分は null になります。
virtualEventSession のすべてのプロパティを取得するには、Get virtualEventSession メソッドを使用します。
注:
仮想イベント ウェビナーでは、単一の仮想イベント セッションのみを使用できます。 1 つのセッションの概要がコレクションに返されます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | VirtualEvent.Read | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | VirtualEvent.Read.All | 注意事項なし。 |
HTTP 要求
GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/sessions
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答コード 200 OK と、応答本文の virtualEventSession オブジェクトのコレクションを返します。
現時点では、 virtualEventSession オブジェクトの次のプロパティにのみ、このメソッドによって オブジェクトが返されるときにデータが含まれます。 その他のプロパティはすべて null です。 virtualEventSession のすべてのプロパティを取得するには、Get virtualEventSession メソッドを使用します。
| プロパティ | 型 | 説明 |
|---|---|---|
| endDateTime | DateTimeTimeZone | 仮想イベント セッションの終了時刻。 |
| id | String | 仮想イベント セッションの一意識別子。 読み取り専用です。 onlineMeetingBase から継承されます。 |
| joinWebUrl | String | 仮想イベント セッションの参加 URL。 読み取り専用です。 onlineMeetingBase から継承されます。 |
| startDateTime | DateTimeTimeZone | 仮想イベント セッションの開始時刻。 |
| subject | String | 仮想イベント セッションの件名。 onlineMeetingBase から継承されます。 |
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/sessions
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.virtualEventSession",
"id": "8d62dd52-4dff-4c75-96a9-f905cc3ff942",
"startDateTime": "2023-08-08T12:30:00Z",
"endDateTime": "2023-08-09T22:00:00Z",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_ZDVjNzk3OWEtYjc2NS00NTA1LTkyMzQtYTYzMGI5YmFmMjM5%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%221cd068e4-5b08-4e75-a7f9-7b4e067a0820%22%7d",
"subject": "Session one",
"isBroadcast": null,
"broadcastSettings": null,
"capabilities": [],
"audioConferencing": null,
"chatInfo": null,
"videoTeleconferenceId": null,
"externalId": null,
"joinMeetingIdSettings": null,
"lobbyBypassSettings": null,
"isEntryExitAnnounced": null,
"allowedPresenters": null,
"allowAttendeeToEnableMic": null,
"allowAttendeeToEnableCamera": null,
"allowMeetingChat": null,
"shareMeetingChatHistoryDefault": null,
"allowTeamworkReactions": null,
"recordAutomatically": null,
"watermarkProtection": null,
"allowParticipantsToChangeName": null
}
]
}