Listar sessões para um registro de evento virtual

Namespace: microsoft.graph

Obtenha uma lista de resumos de sessões para os quais um inscrito se registrou em um webinar ou reunião geral. Um resumo de sessão contém apenas endDateTime, id, joinWebUrl, startDateTime e o assunto de uma sessão de evento virtual. As propriedades de sessão restantes são null.

Para obter todas as propriedades de um virtualEventSession, use o método Get virtualEventSession .

Observação

Webinars de eventos virtuais e reuniões gerais só podem ter uma única sessão de evento virtual. Um único resumo de sessão será retornado na coleção.

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) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application VirtualEvent.Read. Chat Indisponível.

Observação

A VirtualEvent.Read.Chat permissão usa o consentimento específico do recurso.

Solicitação HTTP

Para listar os registros de sessão de um webinar:

GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/sessions

Para listar os registros de sessão de uma reunião geral:

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

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/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/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
    }
  ]
}
  • Last updated on