Create virtualEventRegistration

Namespace: microsoft.graph

Crie um registro para um registrante de um webinar ou reunião geral. Esse método registra a pessoa para o webinar ou a reunião geral.

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

Observação

A VirtualEventRegistration-Anon.ReadWrite.Chat permissão usa o consentimento específico do recurso.

Solicitação HTTP

Para criar um registro de um webinar:

POST /solutions/virtualEvents/webinars/{webinarId}/registrations

Para criar um registro de uma reunião geral:

POST /solutions/virtualEvents/townhalls/{townhallId}/registrations

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 da solicitação, forneça uma representação JSON de um objeto virtualEventRegistration .

Você pode especificar as propriedades a seguir ao criar um virtualEventRegistration com permissão delegada.

Propriedade Tipo Descrição
externalRegistrationInformation virtualEventExternalRegistrationInformation As informações externas de um registro de evento virtual. Opcional.
preferredTimezone Cadeia de caracteres Os detalhes do fuso horário do registrante. Obrigatório.
preferredLanguage Cadeia de caracteres O idioma preferencial do registrante. Obrigatório.
de registroPerguntasRespostas coleção virtualEventRegistrationQuestionAnswer A resposta do registrante às perguntas de registro. Opcional.

Você pode especificar as propriedades a seguir ao criar um virtualEventRegistration com permissão de aplicativo.

Propriedade Tipo Descrição
firstName Cadeia de caracteres O primeiro nome do registrante. Obrigatório.
lastName Cadeia de caracteres O sobrenome do registrante. Obrigatório.
email Cadeia de caracteres O endereço de email do registrante. Obrigatório.
externalRegistrationInformation virtualEventExternalRegistrationInformation As informações externas de um registro de evento virtual. Opcional.
preferredTimezone Cadeia de caracteres Os detalhes do fuso horário do registrante. Obrigatório.
preferredLanguage Cadeia de caracteres O idioma preferencial do registrante. Obrigatório.
de registroPerguntasRespostas coleção virtualEventRegistrationQuestionAnswer A resposta do registrante às perguntas de registro. Opcional.

Resposta

Se for bem-sucedido, esse método retornará um dos seguintes resultados:

  • Um código de 201 Created resposta e um objeto virtualEventRegistration para permissões delegadas.
  • Um 204 No Content código de resposta para permissões de aplicativo.

Exemplos

Exemplo 1: Criando registro com permissão delegada

Use a permissão delegada para criar um registro para uma pessoa que tenha um Microsoft Entra ID como uma forma de registrar um usuário do Microsoft Entra em um webinar.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
Content-Type: application/json

{
  "externalRegistrationInformation": {
    "referrer": "Fabrikam",
    "registrationId": "myExternalRegistrationId"
  },
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Cancun",
        "Hoboken",
        "Beijing"
      ]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.virtualEventRegistration",
  "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
  "userId": "String",
  "firstName": "Emilee",
  "lastName": "Pham",
  "email": "EmileeMPham@contoso.com",
  "externalRegistrationInformation": {
    "referrer": "Fabrikam",
    "registrationId": "myExternalRegistrationId"
  },
  "status": "registered",
  "registrationDateTime": "2023-03-07T22:04:17",
  "cancelationDateTime": null,
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "displayName": "Which city do you currently work in?",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "displayName": "Do you live in the same city where you work?",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "displayName": "Which cities have you worked in?",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Cancun",
        "Hoboken",
        "Beijing"
      ]
    }
  ]
}

Exemplo 2: Criando registro com permissão de aplicativo

Use a permissão do aplicativo para criar um registro de registro para uma pessoa que não tem um Microsoft Entra ID como uma maneira de registrar um usuário anônimo para um webinar.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
Content-Type: application/json

{
  "firstName" : "Diane",
  "lastName" : "Demoss",
  "email" : "DianeDemoss@contoso.com",
  "externalRegistrationInformation": {
    "referrer": "Fabrikam",
    "registrationId": "myExternalRegistrationId"
  },
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "London",
        "New York City"
      ]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content