Class ItemResponse

ItemResponse

Una risposta a un elemento di domanda all'interno di un modulo. È possibile accedere alle risposte agli elementi da FormResponse e crearle da qualsiasi Item che chieda al rispondente di rispondere a una domanda.

// 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(),
    );
  }
}

Metodi

MetodoTipo restituitoBreve descrizione
getFeedback()ObjectRecupera il feedback fornito per la risposta inviata dal rispondente.
getItem()ItemRecupera l'elemento della domanda a cui risponde questa risposta.
getResponse()ObjectRecupera la risposta inviata dal rispondente.
getScore()ObjectRecupera il punteggio della risposta inviata dal partecipante.
setFeedback(feedback)ItemResponseImposta il feedback da visualizzare per la risposta inviata dal rispondente.
setScore(score)ItemResponseImposta il punteggio per la risposta inviata dal partecipante.

Documentazione dettagliata

getFeedback()

Recupera il feedback fornito per la risposta inviata dal rispondente.

Invio

Object: un QuizFeedback per l'elemento della domanda

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getItem()

Recupera l'elemento della domanda a cui risponde questa risposta.

Invio

Item: l'elemento della domanda a cui risponde questa risposta

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getResponse()

Recupera la risposta inviata dal rispondente. Per la maggior parte dei tipi di elementi di domanda, viene restituito un valore String.

Per le domande CheckboxItem, restituisce un array String[] contenente le scelte del rispondente. L'ordine delle stringhe nell'array può variare.

Per le domande GridItem, restituisce un array String[] in cui la risposta all'indice n corrisponde alla domanda nella riga n + 1 della griglia. Se un rispondente non ha risposto a una domanda nella griglia, la risposta viene restituita come ''.

Per le domande CheckboxGridItem, restituisce un array String[][] in cui le risposte all'indice di riga n corrispondono alla domanda nella riga n + 1 della griglia di caselle di controllo. Se un rispondente non ha risposto a una domanda nella griglia, la risposta viene restituita come ''.

Invio

Object: un String, un String[] o un String[][] di risposte all'elemento della domanda

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getScore()

Recupera il punteggio della risposta inviata dal partecipante.

Invio

Object: un Double che rappresenta il punteggio per l'elemento della domanda

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setFeedback(feedback)

Imposta il feedback da visualizzare per la risposta inviata dal rispondente.

Questo metodo non salva effettivamente il feedback in Moduli finché non viene chiamato Form.submitGrades(responses) con le risposte del modulo aggiornate. Per un esempio, vedi setScore().

Parametri

NomeTipoDescrizione
feedbackObject

Invio

ItemResponse: un ItemResponse per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setScore(score)

Imposta il punteggio per la risposta inviata dal partecipante. Un valore nullo comporta l'eliminazione del voto esistente.

Questo metodo non salva effettivamente il punteggio in Moduli finché non viene chiamato Form.submitGrades(responses) con le risposte ai moduli aggiornate.

// 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);

Parametri

NomeTipoDescrizione
scoreObject

Invio

ItemResponse: un ItemResponse per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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