Criar meetingRegistrant

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.

Registre um registro de reunião em uma reunião online que tenha o registro de reunião habilitado em nome do registro. Esta operação tem dois cenários:

  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for , os registros serão necessários para entrar antes de se registrarem organization na reunião. O firstName, lastName e email devem corresponder às informações armazenadas Azure Active Directory (Azure AD).
  • Se o valor da propriedade allowedRegistrant do objeto meetingRegistration for , os registrantes não serão necessários para entrar e serão considerados everyone anônimos.

Em qualquer cenário, o registro receberá uma notificação por email que contém suas informações de registro.

Permissions

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.Read.All

Dica

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

Solicitação HTTP

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

Observação: userId é o objectID do organizador da reunião.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON das propriedades editáveis de um objeto meetingRegistrant.

Importante

Você deve fornecer a **propriedade @odata.type** para especificar o tipo de registro. Para obter mais detalhes, consulte o exemplo a seguir.

Resposta

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto meetingRegistrant parcial no corpo da resposta.

Dica

O corpo da resposta conterá informações diferentes, dependendo do valor de allowedRegistrant.

  • Se o valor da propriedade allowedRegistrant for , somente id e joinWebUrl serão retornados organization no objeto meetingRegistrant. Os registrantes podem usar a id para cancelar seu registro ou ingressar noWebUrl para ingressar na reunião.
  • Se o valor da propriedade allowedRegistrant for everyone , um objeto meetingRegistrant vazio será retornado. Os registrantes precisam usar os links no email que recebem para cancelar o registro ou ingressar na reunião.

Exemplos

Exemplo 1: Registrar um registrante de assinatura

O exemplo a seguir mostra como registrar um registro inscrito com a permissão delegada do registro 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: Registrar um registro anônimo

O exemplo a seguir mostra como registrar um registro anônimo com permissão de aplicativo 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": []
}