Criar ReuniãoOnline

Artigo
07/18/2022
9 minutos para o fim da leitura

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 de versão.

Criar uma reunião online em nome de um usuário.

Dica

Essa API cria uma reunião autônoma que não está associada a nenhum evento no calendário do usuário; portanto, as reuniões criadas por meio dessa API não serão mostradas no calendário do usuário.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	OnlineMeetings.ReadWrite
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	OnlineMeetings.ReadWrite.All*

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 a um usuário para autorizar o aplicativo configurado na política a criar reuniões online em nome desse usuário (com a ID de usuário especificada no caminho da solicitação).

Solicitação HTTP

Criar uma reunião online com permissão delegada (/me) e aplicativo (/users/{userId}):

POST /me/onlineMeetings
POST /users/{userId}/onlineMeetings

Observação

userId é a ID de objeto de um usuário no Portal de gerenciamento de usuário do Azure. Para obter mais detalhes, consulte Permitir o acesso de aplicativos a reuniões online em nome de um usuário.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.
Content-type	application/json. Obrigatório.
Accept-Language	Idioma. Opcional.

Se a solicitação contiver um Accept-Languagecabeçalho HTTP, o content de joinInformation estará na variante de idioma e código de idioma especificada Accept-Language no cabeçalho. O conteúdo padrão será em inglês.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON de um objeto onlineMeeting.

Cuidado

Não há suporte para atribuir o presenter ou coorganizer a função a usuários que não estão registrados no Azure Active Directory. Para obter detalhes, consulte Problemas conhecidos para obter mais detalhes.

Resposta

Se bem-sucedido, este método retorna o código de resposta 201 Created e um objeto onlineMeeting no corpo da resposta.

Exemplos

Exemplo 1: Crie uma reunião online com token de usuário

Solicitação

Veja a seguir um exemplo de uma solicitação.

POST https://graph.microsoft.com/beta/me/onlineMeetings
Content-Type: application/json

{
  "startDateTime":"2019-07-12T14:30:34.2444915-07:00",
  "endDateTime":"2019-07-12T15:00:34.2464912-07:00",
  "subject":"User Token Meeting"
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var onlineMeeting = new OnlineMeeting
{
    StartDateTime = DateTimeOffset.Parse("2019-07-12T21:30:34.2444915+00:00"),
    EndDateTime = DateTimeOffset.Parse("2019-07-12T22:00:34.2464912+00:00"),
    Subject = "User Token Meeting"
};

await graphClient.Me.OnlineMeetings
    .Request()
    .AddAsync(onlineMeeting);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não dão suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.