Class ItemResponse

ItemResponse

Odpowiedź na jedno pytanie z formularza. Odpowiedzi na elementy można wyświetlić w usłudze FormResponse i utworzyć za pomocą dowolnego Item, który zawiera prośbę 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ę otrzymaną na podstawie odpowiedzi respondenta.
getItem()ItemPobiera element pytania, na który stanowi odpowiedź.
getResponse()ObjectPobiera odpowiedź przesłaną przez użytkownika.
getScore()ObjectPobiera wynik odpowiedzi respondenta.
setFeedback(feedback)ItemResponseOkreśla komentarz, który powinien wyświetlić się respondentowi.
setScore(score)ItemResponseUstawia wynik dla odpowiedzi respondenta.

Szczegółowa dokumentacja

getFeedback()

Pobiera opinię otrzymaną na podstawie odpowiedzi respondenta.

Zwróć

Object – QuizFeedback dla elementu pytania

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getItem()

Pobiera element pytania, na który stanowi odpowiedź.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getResponse()

Pobiera odpowiedź przesłaną przez użytkownika. W przypadku większości typów pytań zwracany jest kod String.

W przypadku pytań CheckboxItem zwraca tablicę String[] zawierającą odpowiedzi respondenta. Kolejność ciągów w tablicy może się różnić.

W przypadku pytań GridItem zwracana jest tablica String[], w której odpowiedź na pytanie n odpowiada odpowiedzi w wierszu n + 1 na siatce. Jeśli użytkownik nie odpowiedział na pytanie w siatce, odpowiedź jest zwracana jako ''.

W przypadku pytań CheckboxGridItem zwracana jest tablica String[][], w której odpowiedź w indeksie wiersza n odpowiada pytaniem w wierszu n + 1 w siatce pól wyboru. Jeśli respondent nie odpowiedział na pytanie w siatce, zostanie zwrócona jako ''.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getScore()

Pobiera wynik odpowiedzi respondenta.

Zwróć

Object – Double reprezentujący wynik elementu pytania

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wyświetlić się respondentowi.

Ta metoda nie zapisuje informacji zwrotnych w Formularzach, dopóki Form.submitGrades(responses) nie zostanie wywołany ze zaktualizowanymi odpowiedziami w formularzach. Przykład znajdziesz w sekcji setScore().

Parametry

NazwaTypOpis
feedbackObject

Zwróć

ItemResponse – ItemResponse (łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setScore(score)

Ustawia wynik dla odpowiedzi respondenta. Wartość null powoduje usunięcie obecnego wyniku.

Ta metoda nie zapisuje wyniku w Formularzach, dopóki nie zostanie wywołana właściwość Form.submitGrades(responses) z zaktualizowanymi odpowiedziami w Formularzach. 

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

Zwróć

ItemResponse – ItemResponse (łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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