Compartilhar via


Listar sessões para um evento virtual

Namespace: microsoft.graph

Obtenha uma lista de todos os objetos de resumo virtualEventSession num evento virtual. Um resumo da sessão contém apenas , endDateTimeid, joinWebUrl, startDateTimee subject de uma sessão de evento virtual. As restantes propriedades da sessão serão nulas.

Atualmente, são suportados os seguintes tipos de eventos virtuais:

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 utilizar permissões de aplicação para esta API, os administradores inquilinos têm de criar uma política de acesso à aplicação e atribuí-la a um utilizador. Isto permite que a aplicação autorizada aceda às informações dos registos a partir de eventos virtuais criados por esse utilizador 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 câmara municipal:

GET /solutions/virtualEvents/townhalls/{townhallId}/sessions

Parâmetros de consulta opcionais

Este método não suporta os 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, este método devolve um 200 OK código de resposta e uma coleção de objetos virtualEventSession no corpo da resposta.

Atualmente, apenas as seguintes propriedades de um objeto virtualEventSession contêm dados quando o objeto é devolvido por este método. Todas as outras propriedades são nulas. Para obter todas as propriedades de uma virtualEventSession, utilize o método Get virtualEventSession .

Propriedade Tipo Descrição
endDateTime DateTimeTimeZone A hora de fim da sessão de evento virtual.
id Cadeia de caracteres O identificador exclusivo da sessão de evento virtual. Somente leitura. Herdado de onlineMeetingBase.
joinWebUrl Cadeia de caracteres O URL de associação da sessão de 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 de 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",
      "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
    }
  ]
}