Class ItemResponse

ItemResponse

Odpowiedź na 1 pytanie w formularzu. Odpowiedzi dotyczące elementów są dostępne w usłudze FormResponse. Można je tworzyć z poziomu dowolnego elementu Item, w którym użytkownik musi odpowiedzieć na pytanie. 

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

Metody

MetodaZwracany typKrótki opis
getFeedback()ObjectPobiera informacje zwrotne na temat przesłanej odpowiedzi przez respondenta.
getItem()ItemPobiera pytanie, na które odpowiada ta odpowiedź.
getResponse()ObjectOtrzymuje odpowiedź podaną przez respondenta.
getScore()ObjectPobiera wynik dla przesłanej odpowiedzi.
setFeedback(feedback)ItemResponseOkreśla komentarz, który powinien być wyświetlany w przypadku przesłanej odpowiedzi przez respondenta.
setScore(score)ItemResponseOkreśla wynik dla przesłanej odpowiedzi respondenta.

Szczegółowa dokumentacja

getFeedback()

Pobiera informacje zwrotne na temat przesłanej odpowiedzi przez respondenta.

Powrót

Object – QuizFeedback dla elementu pytania

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getItem()

Pobiera pytanie, na które odpowiada ta odpowiedź.

Powrót

Item – pytanie, na które odpowiada ta odpowiedź

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getResponse()

Otrzymuje odpowiedź podaną przez respondenta. W przypadku większości typów pytań zwracany jest błąd String

W przypadku pytań (CheckboxItem) zwraca ona tablicę String[] zawierającą wybór użytkownika. Kolejność ciągów w tablicy może być różna.

W przypadku pytań (GridItem) zwraca tablicę String[], w której odpowiedź równa się indeks n odpowiada pytaniu w wierszu n + 1 w siatce. Jeśli użytkownik nie odpowiedział(a) na pytanie w siatce, zwracana jest odpowiedź ''.

W przypadku pytań (CheckboxGridItem) zwraca tablicę String[][], w której odpowiedzi w indeksie wiersza n odpowiadają pytaniu w wierszu n + 1 w polu wyboru siatkę. Jeśli użytkownik nie odpowiedział na pytanie w siatce, zwracana jest odpowiedź ''.

Powrót

Object – String, String[] lub String[][] odpowiedzi na pytanie element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getScore()

Pobiera wynik dla przesłanej odpowiedzi.

Powrót

Object – Double reprezentujący wynik elementu pytania,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setFeedback(feedback)

Określa komentarz, który powinien być wyświetlany w przypadku przesłanej odpowiedzi przez respondenta.

Ta metoda zapisuje opinie w Formularzach dopiero po wywołaniu funkcji Form.submitGrades(responses) ze zaktualizowanymi odpowiedziami Formularzy. Przykład znajdziesz w sekcji setScore().

Parametry

NazwaTypOpis
feedbackObject

Powrót

ItemResponse – ItemResponse do łańcuchów

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setScore(score)

Określa wynik dla przesłanej odpowiedzi respondenta. Wartość null usuwa istniejące Jak.

Ta metoda zapisuje wynik w Formularzach dopiero po wywołaniu funkcji Form.submitGrades(responses) ze zaktualizowanymi odpowiedziami Formularzy. 

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

Parametry

NazwaTypOpis
scoreObject

Powrót

ItemResponse – ItemResponse do łańcuchów

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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