Listar sessões para um evento virtual

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