Partilhar via


Criar meetingRegistrant (preterido)

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.

Cuidado

A API do registo de reuniões foi preterida e deixará de devolver dados a 12 de dezembro de 2024. Utilize as novas APIs do webinar. Para obter mais informações, veja Descontinuação das APIs beta de registo de reuniões do Microsoft Graph.

Inscrever um registo de reunião numa reunião online que tenha o registo da reunião ativado em nome do registo. Esta operação tem dois cenários:

  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for organization, os registos terão de iniciar sessão antes de se registarem na reunião. O firstName, o lastName e o e-mail têm de corresponder às informações armazenadas no Microsoft Entra ID.
  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for everyone, os registos não terão de iniciar sessão e serão considerados anónimos.

Em qualquer um dos cenários, o registo receberá uma notificação por e-mail que contém as respetivas informações de registo.

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

Dica

  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for organization, utilize a permissão delegada do registo para se inscrever.
  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for everyone, utilize a permissão delegada do registo para se inscrever.

Solicitação HTTP

POST /users/{userId}/onlineMeetings/{id}/registration/registrants

Nota:userId é o objectID do organizador da reunião.

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

No corpo do pedido, forneça uma representação JSON das propriedades editáveis de um objeto meetingRegistrant .

Importante

Tem de fornecer a propriedade @odata.type para especificar o tipo de registo. Para obter mais detalhes, veja o seguinte exemplo.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto meetingRegistrant parcial no corpo da resposta.

Dica

O corpo da resposta conterá informações diferentes consoante o valor de allowedRegistrant.

  • Se o valor da propriedade allowedRegistrant for organization, apenas id e joinWebUrl serão devolvidos no objeto meetingRegistrant . Os registos podem utilizar o ID para cancelar o registo ou aderir aWebUrl para participar na reunião.
  • Se o valor da propriedade allowedRegistrant for everyone, será devolvido um objeto meetingRegistrant vazio. Os registos têm de utilizar as ligações no e-mail que recebem para cancelar o registo ou participar na reunião.

Exemplos

Exemplo 1: Inscrever um registo com sessão iniciada

O exemplo seguinte mostra como inscrever um registo com sessão iniciada com a permissão delegada do registo quando a reunião tiver permitidoRegistrant definido como organization.

Solicitação

POST https://graph.microsoft.com/beta/users/16664f75-11dc-4870-bec6-38c1aaa81431/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Frederick",
  "lastName": "Cormier",
  "email": "frederick.cormier@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "id": "gWWckDBR6UOI8_yzWCzeNw,6pAAiSU1bkGqzLnbHG_muA,bzLh6uR-5EGYsCvtvIvs6Q,E4jbleVFdE6BDf6ei3YBOA,KvXQzK4zfU-5LQj_ZLWgow,A7_SArco00S-Qr707l0vBA,UFakyZrk1K9vBacExW1muA",
  "registrationDateTime": null,
  "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MmE4Mzg1OTItYjg2Ni00ZmNmLWI5NjMtODNkZDJiMWNlNTVi%40thread.v2/0?context=%7b%22Tid%22%3a%22909c6581-5131-43e9-88f3-fcb3582cde37%22%2c%22Oid%22%3a%22dc17674c-81d9-4adb-bfb2-8f6a442e4622%22%2c%22prid%22%3a%22gWWckDBR6UOI8_yzWCzeNw%2c6pAAiSa1bkGqzLnbHG_muA%2cbzLh6uR-5EGdsCvtvIvs6Q%2cE4jbleVFdE6BDf6ei3YBOA%2cKvXQzK4zfU-5LQj_ZLWgow%2cA7_SArco00S-Qr707l0vBA%2cUFaiyZrk1K9vBacExW1muA%22%2c%22isPublic%22%3afalse%7d",
  "firstName": null,
  "lastName": null,
  "email": null,
  "status": null,
  "customQuestionAnswers": []
}

Exemplo 2: Inscrever um registo anónimo

O exemplo seguinte mostra como inscrever um registo anónimo com permissão de aplicação quando a reunião tiver permitidoRegistrant definido como everyone.

Solicitação

POST https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Lisa",
  "lastName": "Adkins",
  "email": "lisa.adkins@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
    "@odata.type": "#microsoft.graph.meetingRegistrant",
    "id": "",
    "registrationDateTime": null,
    "joinWebUrl": "",
    "firstName": null,
    "lastName": null,
    "email": null,
    "status": null,
    "customQuestionAnswers": []
}