Class ItemResponse

ItemResponse

Odpowiedź na pytanie w formularzu. Dostęp do odpowiedzi na pytania można uzyskać z poziomu FormResponse, a tworzyć je można w dowolnym Item, w którym respondent jest proszony o odpowiedź na pytanie.

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

Metoda	Zwracany typ	Krótki opis
getFeedback()	Object	Pobiera opinię przekazaną na temat przesłanej odpowiedzi.
getItem()	Item	Pobiera element pytania, na które odpowiada ta odpowiedź.
getResponse()	Object	Pobiera odpowiedź przesłaną przez użytkownika.
getScore()	Object	Pobiera wynik przesłanej odpowiedzi respondenta.
setFeedback(feedback)	ItemResponse	Ustawia opinię, która powinna być wyświetlana w odpowiedzi na przesłaną odpowiedź respondenta.
setScore(score)	ItemResponse	Ustawia wynik przesłanej odpowiedzi.

Szczegółowa dokumentacja

getFeedback()

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

Powrót

Object – QuizFeedback dla elementu pytania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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óre odpowiada ta odpowiedź.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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ń zwraca wartość String.

W przypadku pytań CheckboxItem zwraca tablicę String[] zawierającą wybory osoby odpowiadającej. Kolejność ciągów znaków w tablicy może być różna.

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

W przypadku pytań typu CheckboxGridItem zwraca tablicę String[][], w której odpowiedzi w wierszu o indeksie n odpowiadają pytaniu w wierszu n + 1 w siatce pól wyboru. Jeśli respondent nie odpowie na pytanie w tabeli, odpowiedź zostanie zwrócona jako ''.

Powrót

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

Autoryzacja

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

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

---

getScore()

Pobiera wynik przesłanej odpowiedzi respondenta.

Powrót

Object – Double reprezentujący wynik pytania.

Autoryzacja

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

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

---

setFeedback(feedback)

Ustawia opinię, która powinna być wyświetlana w odpowiedzi na przesłaną odpowiedź respondenta.

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

Parametry

Nazwa	Typ	Opis
feedback	Object

Powrót

ItemResponse – ItemResponse do łączenia

Autoryzacja

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

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

---

setScore(score)

Ustawia wynik przesłanej odpowiedzi. Wartość null spowoduje usunięcie istniejącego wyniku.

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

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

Nazwa	Typ	Opis
score	Object

Powrót

ItemResponse – ItemResponse do łączenia

Autoryzacja

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

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