Répertorier les sessions d’un événement virtuel
Espace de noms: microsoft.graph
Obtenez la liste de tous les objets récapitulatives virtualEventSession sous un événement virtuel. Un résumé de session contient uniquement les endDateTime
éléments , id
, joinWebUrl
, startDateTime
et subject
d’une session d’événements virtuels. Le reste des propriétés de session sera null.
Actuellement, les types d’événements virtuels suivants sont pris en charge :
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | VirtualEvent.Read | VirtualEvent.ReadWrite |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | VirtualEvent.Read.All | Non disponible. |
Notes
Pour utiliser les autorisations d’application pour cette API, les administrateurs clients doivent créer une stratégie d’accès à l’application et l’affecter à un utilisateur. Cela permet à l’application autorisée d’accéder aux informations des inscrits à partir d’événements virtuels créés par cet utilisateur spécifique.
Pour lister toutes les sessions d’un webinaire :
GET /solutions/virtualEvents/webinars/{webinarId}/sessions
Pour lister toutes les sessions d’une assemblée générale :
GET /solutions/virtualEvents/townhalls/{townhallId}/sessions
Cette méthode ne prend pas en charge les paramètres de requête OData. Pour des informations générales, consultez paramètres de la requête OData.
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
N’indiquez pas le corps de la demande pour cette méthode.
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et une collection d’objets virtualEventSession dans le corps de la réponse.
Actuellement, seules les propriétés suivantes d’un objet virtualEventSession contiennent des données lorsque l’objet est retourné par cette méthode. Toutes les autres propriétés sont null. Pour obtenir toutes les propriétés d’une virtualEventSession, utilisez la méthode Get virtualEventSession .
Propriété | Type | Description |
---|---|---|
endDateTime | DateTimeTimeZone | Heure de fin de la session d’événements virtuelle. |
id | Chaîne | Identificateur unique de la session d’événements virtuels. En lecture seule. Hérité de onlineMeetingBase. |
joinWebUrl | Chaîne | URL de jointure de la session d’événements virtuels. En lecture seule. Hérité de onlineMeetingBase. |
startDateTime | DateTimeTimeZone | Heure de début de la session d’événements virtuels. |
subject | Chaîne | Objet de la session d’événements virtuels. Hérité de onlineMeetingBase. |
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f8ce2a5f-0e6a-4186-aa90-1f64bc023566@5466a424-aadf-425c-9b24-034ca28d4bdd/sessions
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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
}
]
}