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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getFeedback() | Object | pobiera opinię o przesłanej odpowiedzi użytkownika, |
getItem() | Item | Pobiera pytanie, na które odpowiada ta odpowiedź. |
getResponse() | Object | – pobiera odpowiedź przesłaną przez respondenta. |
getScore() | Object | Zbiera wynik dla odpowiedzi użytkownika. |
setFeedback(feedback) | ItemResponse | Określa komentarz, który powinien być wyświetlany dla odpowiedzi użytkownika. |
setScore(score) | ItemResponse | Ustawia wynik przesłanej odpowiedzi użytkownika. |
Szczegółowa dokumentacja
getFeedback()
pobiera opinię o przesłanej odpowiedzi użytkownika,
Powroty
Object
– QuizFeedback
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
Object
– String
, 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
Object
– Double
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
Nazwa | Typ | Opis |
---|---|---|
feedback | Object |
Powroty
ItemResponse
– ItemResponse
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
Nazwa | Typ | Opis |
---|---|---|
score | Object |
Powroty
ItemResponse
– ItemResponse
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