virtualEventWebinar: getByUserIdAndRole
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha uma lista de objetos virtualEventWebinar em que o usuário especificado é o organizador ou um coorganizador.
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Sem suporte. | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | VirtualEvent.Read.All | Indisponível. |
Importante
Para usar a permissão de aplicativo para essa API, os administradores de locatários devem criar uma política de acesso de aplicativo e concedê-la ao usuário especificado para autorizar o aplicativo a obter webinars em nome desse usuário.
Solicitação HTTP
GET /solutions/virtualEvents/webinars/getByUserIdAndRole(userId='{userId}', role='{role}')
Parâmetros de função
Na URL da solicitação, forneça os seguintes parâmetros de consulta com valores.
Parâmetro | Tipo | Descrição |
---|---|---|
userId | Cadeia de caracteres | A ID do usuário especificado no Microsoft Entra. |
role | Cadeia de caracteres | Função de usuário do usuário especificado no webinar. Os valores possíveis são: organizer e coOrganizer . |
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-sucedida, essa função retornará um 200 OK
código de resposta e uma coleção de objetos virtualEventWebinar no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/getByUserIdAndRole(userId='b7ef013a-c73c-4ec7-8ccb-e56290f45f68', role='organizer')
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.virtualEventWebinar",
"id": "88b245ac-b0b2-f1aa-e34a-c81c27abdac2@f9448ec4-804b-46af-b810-62085248da33",
"status": "published",
"displayName": "The Impact of Tech on Our Lives",
"description": {
"contentType": "text",
"content": "Discusses how technology has changed the way we communicate, work, and interact with each other."
},
"startDateTime": {
"dateTime": "2023-03-30T10:00:00",
"timeZone": "PacificSt"
},
"endDateTime": {
"dateTime": "2023-03-30T17:00:00",
"timeZone": "PacificSt"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.communicationsUserIdentity",
"id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
"displayName": "Diane Demoss",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
},
"audience": "everyone",
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"displayName": "Kenneth Brown",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"settings": {
"isAttendeeEmailNotificationEnabled": false
}
}
]
}