Element pytania, który umożliwia respondentowi przyznanie oceny. Do elementów można uzyskać dostęp lub je utworzyć z poziomu Form
. Gdy są używane w teście, są oceniane.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and access its properties. const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); const ratingScaleLevel = existingRatingItem.getRatingScaleLevel(); const ratingIcon = existingRatingItem.getRatingIcon(); // Create a new rating item. const ratingItem = form.addRatingItem(); // Update the rating item's properties via chaining. ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createResponse(response) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu oceny. |
duplicate() | RatingItem | Tworzy kopię tego elementu i dodaje ją na końcu formularza. |
getGeneralFeedback() | QuizFeedback | Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane. |
getHelpText() | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator produktu. |
getIndex() | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
getPoints() | Integer | Zwraca liczbę punktów za element, który można ocenić. |
getRatingIcon() | RatingIconType | Pobiera ikonę wybraną dla oceny. |
getRatingScaleLevel() | Integer | Pobiera poziom skali oceny. |
getTitle() | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem ). |
getType() | ItemType | Pobiera typ elementu jako ItemType . |
isRequired() | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
setGeneralFeedback(feedback) | RatingItem | Określa informacje zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznej oceny). |
setHelpText(text) | RatingItem | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | RatingItem | Określa liczbę punktów, które można przyznać ocenianemu elementowi. |
setRatingIcon(ratingIcon) | RatingItem | Ustawia ikonę oceny. |
setRatingScaleLevel(ratingScaleLevel) | RatingItem | Ustawia poziom skali oceny. |
setRequired(enabled) | RatingItem | Określa, czy respondent musi odpowiedzieć na pytanie. |
setTitle(title) | RatingItem | Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem ). |
Szczegółowa dokumentacja
createResponse(response)
Tworzy nowy element ItemResponse
dla tego elementu oceny.
Wyjątek skryptu jest zgłaszany, jeśli podana wartość response
jest mniejsza niż 1
lub większa niż wartość zwracana przez funkcję getRatingScaleLevel()
.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and create a new response for it. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); const response =item.createResponse(5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | Integer | Wartość odpowiedzi na ten element oceny. |
Powrót
ItemResponse
– odpowiedź dotycząca elementu.
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
duplicate()
Tworzy kopię tego elementu i dodaje ją na końcu formularza.
Powrót
RatingItem
– duplikat tego elementu RatingItem
, służący do łańcuchowania.
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
getGeneralFeedback()
Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane.
Powrót
QuizFeedback
– opinia (jeśli została przesłana).
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
getHelpText()
Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powrót
String
– tekst pomocy lub tekst opisu produktu,
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
getId()
Pobiera unikalny identyfikator produktu.
Powrót
Integer
– identyfikator produktu
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
getIndex()
Pobiera indeks elementu spośród wszystkich elementów w formularzu.
Powrót
Integer
– indeks elementu
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
getPoints()
Zwraca liczbę punktów za element, który można ocenić.
Powrót
Integer
– liczba punktów, jaką można uzyskać za pytanie.
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
getRatingIcon()
Pobiera ikonę wybraną dla oceny.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and get its rating icon. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); const ratingIcon = item.getRatingIcon();
Powrót
RatingIconType
– typ ikony oceny.
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
getRatingScaleLevel()
Pobiera poziom skali oceny.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and get its rating scale level. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); const ratingScaleLevel = item.getRatingScaleLevel();
Powrót
Integer
– poziom skali ocen.
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
getTitle()
Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem
).
Powrót
String
– tytuł lub tekst nagłówka
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
getType()
isRequired()
Określa, czy respondent musi odpowiedzieć na pytanie.
Powrót
Boolean
– czy respondent musi odpowiedzieć na pytanie
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
setGeneralFeedback(feedback)
Określa informacje zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznej oceny).
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowe opinie |
Powrót
RatingItem
– ta RatingItem
, aby utworzyć łańcuch
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
setHelpText(text)
Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
RatingItem
– ta RatingItem
, aby utworzyć łańcuch
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
setPoints(points)
Określa liczbę punktów, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów za pytanie |
Powrót
RatingItem
– ta RatingItem
, aby utworzyć łańcuch
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
setRatingIcon(ratingIcon)
Ustawia ikonę oceny.
Wyjątek skryptu, jeśli typ ikony oceny jest nieprawidłowy.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and set its rating icon. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratingIcon | RatingIconType | Typ ikony oceny. |
Powrót
RatingItem
– ta RatingItem
służy do tworzenia łańcuszków.
Rzuty
Error
– jeśli typ ikony oceny jest nieprawidłowy.
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
setRatingScaleLevel(ratingScaleLevel)
Ustawia poziom skali oceny. Poziom skali oceny musi mieścić się w zakresie od 3
do 10
(włącznie). Nowa ocena jest domyślnie przypisana do poziomu skali ocen 3
.
Wyjątek skryptu, jeśli podane wartości wykraczają poza dozwolone limity.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and set its rating scale level. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); item.setRatingScaleLevel(7);
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratingScaleLevel | Integer | Poziom skali ocen. |
Powrót
RatingItem
– ta RatingItem
służy do tworzenia łańcuszków.
Rzuty
Error
– jeśli poziom skali ocen jest nieprawidłowy,
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
setRequired(enabled)
Określa, czy respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
RatingItem
– bieżący element (do łańcuchowania).
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
setTitle(title)
Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
RatingItem
– ta RatingItem
, aby utworzyć łańcuch
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