Class ItemResponse

ItemResposta

Uma resposta a um item de pergunta em um formulário. As respostas de itens podem ser acessadas em FormResponse e criadas em qualquer Item que peça ao respondente para responder a uma pergunta. 

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

Métodos

MétodoTipo de retornoBreve descrição
getFeedback()ObjectRecebe o feedback fornecido para a resposta enviada pelo participante.
getItem()ItemExtrai o item de pergunta que esta resposta responde.
getResponse()ObjectRecebe a resposta enviada pelo participante.
getScore()ObjectRecebe a pontuação da resposta enviada pelo participante.
setFeedback(feedback)ItemResponseDefine o feedback que será mostrado para a resposta enviada pelo participante.
setScore(score)ItemResponseDefine 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 exigem autorização com um ou mais dos seguintes escopos:

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

getItem()

Extrai o item de pergunta que esta resposta responde.

Retornar

Item: o item de pergunta que essa resposta responde

Autorização

Os scripts que usam esse método exigem 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 um String.

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

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

Para perguntas CheckboxGridItem, isso retorna uma matriz String[][] em que as respostas no índice de linha n correspondem à pergunta na linha n + 1 na grade de caixas de seleção. Se um participante não responder a uma pergunta na grade, essa resposta será retornada como ''.

Retornar

Object: um String ou String[] ou String[][] de respostas ao item da pergunta

Autorização

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

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

getScore()

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

Retornar

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

Autorização

Os scripts que usam esse método exigem 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 será mostrado para a resposta enviada pelo participante.

Esse método não salva o feedback no app Formulários até que Form.submitGrades(responses) seja chamado com as respostas atualizadas. Consulte setScore() para conferir um exemplo.

Parâmetros

NomeTipoDescrição
feedbackObject

Retornar

ItemResponse: um ItemResponse para encadeamento

Autorização

Os scripts que usam esse método exigem 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 a pontuação existente.

Esse método não salva a pontuação no Forms até que Form.submitGrades(responses) seja chamado com as respostas de formulário atualizadas. 

// For a multiple choice question with options: "Always true", "Sometimes true",
// and "Never", award half credit for responses that answered "Sometimes true".
const formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (let i = 0; i < formResponses.length; i++) {
  const response = formResponses[i];
  const items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  const item = items[0];
  const itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() === 'Sometimes true') {
    const points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * 0.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

NomeTipoDescrição
scoreObject

Retornar

ItemResponse: um ItemResponse para encadeamento

Autorização

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

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