Namespace: microsoft.graph
Crie uma pergunta de registro para um webinar ou reunião geral.
Você pode criar uma pergunta de registro predefinida ou uma pergunta de registro personalizada.
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. |
| Aplicativo |
Sem suporte. |
Sem suporte. |
Solicitação HTTP
Para criar uma pergunta na configuração de registro de um webinar:
POST /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions
Para criar uma pergunta na configuração de registro de uma reunião geral:
POST /solutions/virtualEvents/townhalls/{townhallId}/registrationConfiguration/questions
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON de um virtualEventRegistrationCustomQuestion ou um objeto virtualEventRegistrationPredefinedQuestion .
Você pode especificar as propriedades a seguir ao criar um virtualEventRegistrationCustomQuestion.
| Propriedade |
Tipo |
Descrição |
| answerChoices |
String collection |
Opções de resposta quando answerInputType é singleChoice ou multiChoice. |
| answerInputType |
virtualEventRegistrationQuestionAnswerInputType |
Tipo de entrada da resposta da pergunta de registro. Os valores com suporte são text, multilineText, singleChoice, booleanmultiChoice, e unknownFutureValue. |
| displayName |
Cadeia de caracteres |
Nome de exibição da pergunta de registro. |
| é necessário |
Booliano |
Indica se uma resposta à pergunta é necessária. O valor padrão é false. |
Você pode especificar a propriedade a seguir ao criar um virtualEventRegistrationPredefinedQuestion.
| Propriedade |
Tipo |
Descrição |
| rótulo |
virtualEventRegistrationPredefinedQuestionLabel |
Rótulo da pergunta de registro predefinida. Os seguintes valores de rótulo aceitam uma única linha de texto: street, city, state, countryOrRegionpostalCode, , industry, jobTitle, , organization, e unknownFutureValue. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto virtualEventRegistrationCustomQuestion ou virtualEventRegistrationPredefinedQuestion no corpo da resposta.
Exemplos
Exemplo 1: Adicionar uma pergunta de registro personalizada a um registro de 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/registrationConfiguration/questions
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.virtualEventRegistrationCustomQuestion",
"displayName": "What's your job position?",
"answerInputType": "multiChoice",
"answerChoices": [
"Software Engineer",
"Engineer Manager",
"Product Manager"
],
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new VirtualEventRegistrationCustomQuestion
{
OdataType = "#microsoft.graph.virtualEventRegistrationCustomQuestion",
DisplayName = "What's your job position?",
AnswerInputType = VirtualEventRegistrationQuestionAnswerInputType.MultiChoice,
AnswerChoices = new List<string>
{
"Software Engineer",
"Engineer Manager",
"Product Manager",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.VirtualEvents.Webinars["{virtualEventWebinar-id}"].RegistrationConfiguration.Questions.PostAsync(requestBody);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewVirtualEventRegistrationQuestionBase()
displayName := "What's your job position?"
requestBody.SetDisplayName(&displayName)
answerInputType := graphmodels.MULTICHOICE_VIRTUALEVENTREGISTRATIONQUESTIONANSWERINPUTTYPE
requestBody.SetAnswerInputType(&answerInputType)
answerChoices := []string {
"Software Engineer",
"Engineer Manager",
"Product Manager",
}
requestBody.SetAnswerChoices(answerChoices)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
questions, err := graphClient.Solutions().VirtualEvents().Webinars().ByVirtualEventWebinarId("virtualEventWebinar-id").RegistrationConfiguration().Questions().Post(context.Background(), requestBody, nil)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
VirtualEventRegistrationCustomQuestion virtualEventRegistrationQuestionBase = new VirtualEventRegistrationCustomQuestion();
virtualEventRegistrationQuestionBase.setOdataType("#microsoft.graph.virtualEventRegistrationCustomQuestion");
virtualEventRegistrationQuestionBase.setDisplayName("What's your job position?");
virtualEventRegistrationQuestionBase.setAnswerInputType(VirtualEventRegistrationQuestionAnswerInputType.MultiChoice);
LinkedList<String> answerChoices = new LinkedList<String>();
answerChoices.add("Software Engineer");
answerChoices.add("Engineer Manager");
answerChoices.add("Product Manager");
virtualEventRegistrationQuestionBase.setAnswerChoices(answerChoices);
VirtualEventRegistrationQuestionBase result = graphClient.solutions().virtualEvents().webinars().byVirtualEventWebinarId("{virtualEventWebinar-id}").registrationConfiguration().questions().post(virtualEventRegistrationQuestionBase);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const virtualEventRegistrationQuestionBase = {
'@odata.type': '#microsoft.graph.virtualEventRegistrationCustomQuestion',
displayName: 'What\'s your job position?',
answerInputType: 'multiChoice',
answerChoices: [
'Software Engineer',
'Engineer Manager',
'Product Manager'
],
};
await client.api('/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions')
.post(virtualEventRegistrationQuestionBase);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\VirtualEventRegistrationCustomQuestion;
use Microsoft\Graph\Generated\Models\VirtualEventRegistrationQuestionAnswerInputType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new VirtualEventRegistrationCustomQuestion();
$requestBody->setOdataType('#microsoft.graph.virtualEventRegistrationCustomQuestion');
$requestBody->setDisplayName('What\'s your job position?');
$requestBody->setAnswerInputType(new VirtualEventRegistrationQuestionAnswerInputType('multiChoice'));
$requestBody->setAnswerChoices(['Software Engineer', 'Engineer Manager', 'Product Manager', ]);
$result = $graphServiceClient->solutions()->virtualEvents()->webinars()->byVirtualEventWebinarId('virtualEventWebinar-id')->registrationConfiguration()->questions()->post($requestBody)->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Import-Module Microsoft.Graph.Bookings
$params = @{
"@odata.type" = "#microsoft.graph.virtualEventRegistrationCustomQuestion"
displayName = "What's your job position?"
answerInputType = "multiChoice"
answerChoices = @(
"Software Engineer"
"Engineer Manager"
"Product Manager"
)
}
New-MgVirtualEventWebinarRegistrationConfigurationQuestion -VirtualEventWebinarId $virtualEventWebinarId -BodyParameter $params
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.virtual_event_registration_custom_question import VirtualEventRegistrationCustomQuestion
from msgraph.generated.models.virtual_event_registration_question_answer_input_type import VirtualEventRegistrationQuestionAnswerInputType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = VirtualEventRegistrationCustomQuestion(
odata_type = "#microsoft.graph.virtualEventRegistrationCustomQuestion",
display_name = "What's your job position?",
answer_input_type = VirtualEventRegistrationQuestionAnswerInputType.MultiChoice,
answer_choices = [
"Software Engineer",
"Engineer Manager",
"Product Manager",
],
)
result = await graph_client.solutions.virtual_events.webinars.by_virtual_event_webinar_id('virtualEventWebinar-id').registration_configuration.questions.post(request_body)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
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.virtualEventRegistrationCustomQuestion",
"id": "f3115d4c-9896-42fc-a649-8ca5e3c3a43f",
"displayName": "What's your job position?",
"answerInputType": "multiChoice",
"answerChoices": [
"Software Engineer",
"Engineer Manager",
"Product Manager"
],
"isRequired": false
}
Exemplo 2: Adicionar uma pergunta de registro predefinida a um registro de 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/registrationConfiguration/questions
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.VirtualEvents.Webinars["{virtualEventWebinar-id}"].RegistrationConfiguration.Questions.PostAsync(null);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
questions, err := graphClient.Solutions().VirtualEvents().Webinars().ByVirtualEventWebinarId("virtualEventWebinar-id").RegistrationConfiguration().Questions().Post(context.Background(), nil)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
VirtualEventRegistrationQuestionBase result = graphClient.solutions().virtualEvents().webinars().byVirtualEventWebinarId("{virtualEventWebinar-id}").registrationConfiguration().questions().post(null);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrationConfiguration/questions')
.post();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->solutions()->virtualEvents()->webinars()->byVirtualEventWebinarId('virtualEventWebinar-id')->registrationConfiguration()->questions()->post()->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.solutions.virtual_events.webinars.by_virtual_event_webinar_id('virtualEventWebinar-id').registration_configuration.questions.post(None)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.virtualEventRegistrationPredefinedQuestion",
"label": "street"
}
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.virtualEventRegistrationPredefinedQuestion",
"id": "7a852983-013a-4062-9e97-f784c6a57ec8",
"label": "street",
"displayName": "Address",
"isRequired": false
}