Esta página foi traduzida pela API Cloud Translation.

Class ItemResponse

Resposta a um item de pergunta em um formulário. As respostas do item podem ser acessadas em FormResponse e criadas por qualquer Item que peça ao participante para responder a uma pergunta.

// Open a form by ID and log the responses to each question.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  var itemResponses = formResponse.getItemResponses();
  for (var j = 0; j < itemResponses.length; j++) {
    var itemResponse = itemResponses[j];
    Logger.log('Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse());
  }
}

Métodos

Método	Tipo de retorno	Breve descrição
`getFeedback()`	`Object`	Recebe o feedback fornecido para a resposta enviada pelo participante.
`getItem()`	`Item`	Recebe o item da pergunta respondida pela resposta.
`getResponse()`	`Object`	Recebe a resposta enviada pelo participante.
`getScore()`	`Object`	Extrai a pontuação da resposta enviada pelo participante.
`setFeedback(feedback)`	`ItemResponse`	Define o feedback que deve ser exibido para a resposta enviada pelo participante.
`setScore(score)`	`ItemResponse`	Define a pontuação da resposta enviada pelo participante.

Documentação detalhada

`getFeedback()`

Recebe o feedback fornecido para a resposta enviada pelo participante.

Retornar

Object: um QuizFeedback para o item da pergunta.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getItem()`

Recebe o item da pergunta respondida pela resposta.

Retornar

Item: o item da pergunta que esta resposta responde.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getResponse()`

Recebe a resposta enviada pelo participante. Para a maioria dos tipos de itens de pergunta, isso retorna uma String:

Para perguntas CheckboxItem, isso retorna uma matriz String[] contendo o as escolhas do participante. A ordem das strings na matriz pode variar.

Para perguntas GridItem, isso retorna uma matriz String[] em que a resposta em o índice n corresponde à pergunta na linha n + 1 da grade. Se um entrevistado não respondeu a uma pergunta na grade, essa resposta será retornada como ''.

Para perguntas CheckboxGridItem, isso retorna uma matriz String[][] em que o respostas no índice de linha n corresponde à pergunta na linha n + 1 na caixa de seleção rede. Se um participante não respondeu a uma pergunta na grade, essa resposta é retornada como ''.

Retornar

Object: uma String, String[] ou String[][] de respostas à pergunta. item

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getScore()`

Extrai a pontuação da resposta enviada pelo participante.

Retornar

Object: um Double que representa a pontuação do item de pergunta.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setFeedback(feedback)`

Define o feedback que deve ser exibido para a resposta enviada pelo participante.

Esse método não salva o feedback nos Formulários até que Form.submitGrades(responses) seja chamado com o FormResponses atualizado. Consulte setScore() para conferir um exemplo.

Parâmetros

Nome	Tipo	Descrição
`feedback`	`Object`

Retornar

ItemResponse: um ItemResponse para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setScore(score)`

Define a pontuação da resposta enviada pelo participante. Um valor nulo vai limpar o de qualidade.

Esse método não salva a pontuação nos Formulários até que Form.submitGrades(responses) seja chamado com o FormResponses atualizado.

// For a multiple choice question with options: "Always true", "Sometimes true", and "Never",
// award half credit for responses that answered "Sometimes true".
var formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (var i = 0; i < formResponses.length; i++) {
  var response = formResponses[i];
  var items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  var item = items[0];
  var itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') {
    var points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * .5);
    // This saves the grade, but does not submit to Forms yet.
    response.withItemGrade(itemResponse);
  }
}
// Grades are actually submitted to Forms here.
FormApp.getActiveForm().submitGrades(formResponses);

Parâmetros

Nome	Tipo	Descrição
`score`	`Object`

Retornar

ItemResponse: um ItemResponse para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms