Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha uma lista de todos os objetos de resumo virtualEventSession em um evento virtual. Um resumo de sessão contém apenas o endDateTime, id, startDateTimejoinWebUrl, e subject de uma sessão de evento virtual. O restante das propriedades da sessão será nulo.
Atualmente, há suporte para os seguintes tipos de eventos virtuais:
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | VirtualEvent.Read | VirtualEvent.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | VirtualEvent.Read.All | Indisponível. |
Observação
Para usar permissões de aplicativo para essa API, os administradores de locatários devem criar uma política de acesso ao aplicativo e atribuí-la a um usuário. Isso permite que o aplicativo autorizado acesse as informações dos registrantes de eventos virtuais criados por esse usuário específico.
Solicitação HTTP
Para listar todas as sessões de um webinar:
GET /solutions/virtualEvents/webinars/{webinarId}/sessions
Para listar todas as sessões de uma reunião geral:
GET /solutions/virtualEvents/townhalls/{townhallId}/sessions
Parâmetros de consulta opcionais
Esse método não dá suporte aos parâmetros de consulta OData. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos virtualEventSession no corpo da resposta.
Atualmente, somente as propriedades a seguir de um objeto virtualEventSession contêm dados quando o objeto é retornado por esse método. Todas as outras propriedades são null. Para obter todas as propriedades de um virtualEventSession, use o método Get virtualEventSession .
| Propriedade | Tipo | Descrição |
|---|---|---|
| endDateTime | DateTimeTimeZone | A hora de término da sessão do evento virtual. |
| id | Cadeia de caracteres | O identificador exclusivo da sessão de evento virtual. Somente leitura. Herdado de onlineMeetingBase. |
| joinWebUrl | Cadeia de caracteres | A URL de ingresso da sessão do evento virtual. Somente leitura. Herdado de onlineMeetingBase. |
| startDateTime | DateTimeTimeZone | A hora de início da sessão do evento virtual. |
| assunto | Cadeia de caracteres | O assunto da sessão do evento virtual. Herdado de onlineMeetingBase. |
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f8ce2a5f-0e6a-4186-aa90-1f64bc023566@5466a424-aadf-425c-9b24-034ca28d4bdd/sessions
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
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",
"videoOnDemandWebUrl": "https://df.events.teams.microsoft.com/webinars/webinarId/sessions/session1",
"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,
"meetingSpokenLanguageTag": "en-US"
}
]
}