Class ItemResponse

ElementOdpowiedź

Odpowiedź na jeden element pytania w formularzu. Odpowiedzi na elementy są dostępne w sekcji FormResponse i mogą być tworzone w dowolnym Item, który zawiera pytanie do respondenta. 

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

Metody

MetodaZwracany typKrótki opis
getFeedback()ObjectPobiera opinię podaną na temat przesłanej odpowiedzi.
getItem()ItemPobiera element pytania, na które odpowiada ta odpowiedź.
getResponse()ObjectPobiera odpowiedź przesłaną przez respondenta.
getScore()ObjectZwraca wynik przesłanej przez respondenta odpowiedzi.
setFeedback(feedback)ItemResponseOkreśla opinię, która powinna być wyświetlana w przypadku przesłanej odpowiedzi respondenta.
setScore(score)ItemResponseUstawia wynik przesłanej odpowiedzi respondenta.

Szczegółowa dokumentacja

getFeedback()

Pobiera opinię podaną na temat przesłanej odpowiedzi.

Powrót

Object – QuizFeedback dla elementu pytania

Autoryzacja

Skrypty, które korzystają 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 element pytania, na które odpowiada ta odpowiedź.

Powrót

Item – element pytania, na które udzielono odpowiedzi

Autoryzacja

Skrypty, które korzystają 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 pytania zwraca to wartość String.

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

W przypadku pytań GridItem zwraca tablicę String[], w której odpowiedź o indeksie n odpowiada pytaniu w wierszu n + 1 w kratce. Jeśli respondent nie udzielił odpowiedzi na pytanie w tabeli, zwracana jest wartość ''.

W przypadku pytań CheckboxGridItem zwraca tablicę String[][], w której odpowiedzi w indeksie wiersza n odpowiadają pytaniu w wierszu n + 1 w siatce Jeśli respondent nie udzielił odpowiedzi na pytanie w tabeli, zwracana jest wartość ''.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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()

Zwraca wynik przesłanej przez respondenta odpowiedzi.

Powrót

Object – obiekt Double reprezentujący wynik elementu pytania.

Autoryzacja

Skrypty, które korzystają 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 opinię, która powinna być wyświetlana w przypadku przesłanej odpowiedzi respondenta.

Ta metoda nie zapisuje opinii w usłudze Formularze, dopóki nie zostanie wywołana metoda Form.submitGrades(responses) z aktualnymi odpowiedziami z formularza. Przykład znajdziesz w sekcji setScore().

Parametry

NazwaTypOpis
feedbackObject

Powrót

ItemResponse – ItemResponse do tworzenia łańcuszków

Autoryzacja

Skrypty, które korzystają 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 respondenta. Wartość null spowoduje wyczyszczenie dotychczasowej oceny.

Ta metoda nie zapisuje wyniku w Formularzach, dopóki nie zostanie wywołana funkcja Form.submitGrades(responses) z aktualnymi odpowiedziami w formularzu. 

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

Parametry

NazwaTypOpis
scoreObject

Powrót

ItemResponse – ItemResponse do tworzenia łańcuszków

Autoryzacja

Skrypty, które korzystają 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