Class ItemResponse

ItemResponse

Odpowiedź na jedno pytanie w formularzu. Odpowiedzi na pytania są dostępne w usłudze FormResponse. Możesz je utworzyć w dowolnym elemencie Item, w którym użytkownik jest proszony o udzielenie odpowiedzi 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 opinię o przesłanej odpowiedzi użytkownika,
getItem()ItemPobiera pytanie, na które odpowiada ta odpowiedź.
getResponse()Object– pobiera odpowiedź przesłaną przez respondenta.
getScore()ObjectZbiera wynik dla odpowiedzi użytkownika.
setFeedback(feedback)ItemResponseOkreśla komentarz, który powinien być wyświetlany dla odpowiedzi użytkownika.
setScore(score)ItemResponseUstawia wynik przesłanej odpowiedzi użytkownika.

Szczegółowa dokumentacja

getFeedback()

pobiera opinię o przesłanej odpowiedzi użytkownika,

Powroty

ObjectQuizFeedback dla elementu pytania

Upoważnienie

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ź.

Powroty

Item – element pytania, na które odpowiada ta odpowiedź;

Upoważnienie

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()

– pobiera odpowiedź przesłaną przez respondenta. W przypadku większości typów elementów pytań zwraca wartość String.

W przypadku pytań typu CheckboxItem zwracana jest tablica String[] zawierająca opcje respondentów. Kolejność ciągów w tablicy może być różna.

W przypadku pytania typu GridItem zwraca tablicę String[], w której odpowiedź w indeksie n odpowiada pytaniu w wierszu n + 1 w siatce. Jeśli użytkownik nie odpowiedział na pytanie w siatce, ta odpowiedź jest zwracana jako ''.

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

Powroty

ObjectString, String[] lub String[][] odpowiedzi na pytanie.

Upoważnienie

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()

Zbiera wynik dla odpowiedzi użytkownika.

Powroty

ObjectDouble reprezentujący wynik dla elementu pytania.

Upoważnienie

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 dla odpowiedzi użytkownika.

Ta metoda nie zapisuje opinii w Formularzach, dopóki nie zostanie wywołana funkcja Form.submitGrades(responses) ze zaktualizowanymi odpowiedziami na formularz. Przykład znajdziesz na stronie setScore().

Parametry

NazwaTypOpis
feedbackObject

Powroty

ItemResponseItemResponse do tworzenia łańcuchów

Upoważnienie

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)

Ustawia wynik przesłanej odpowiedzi użytkownika. Wartość null usuwa istniejący wynik.

Ta metoda nie zapisuje wyniku w Formularzach, dopóki nie zostanie wywołana funkcja Form.submitGrades(responses) ze zaktualizowanymi wartościami FormResponses.

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

Powroty

ItemResponseItemResponse do tworzenia łańcuchów

Upoważnienie

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