Class RatingItem

Ocenaelementu

Element pytania, który umożliwia użytkownikowi wystawienie oceny. Dostęp do elementów można uzyskać lub tworzyć je w Form. Jeśli są używane w teście, podlegają ocenie.

// 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 ItemResponse dla tego elementu oceny.
duplicate()	RatingItem	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()	QuizFeedback	Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()	String	Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()	Integer	Pobiera unikalny identyfikator elementu.
getIndex()	Integer	Pobiera indeks elementu wśród wszystkich elementów w formularzu.
getPoints()	Integer	Zwraca wartość punktową elementu podlegającego ocenie.
getRatingIcon()	RatingIconType	Pobiera ikonę wybraną dla oceny.
getRatingScaleLevel()	Integer	Pobiera poziom skali oceny.
getTitle()	String	Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()	ItemType	Pobiera typ elementu reprezentowany jako ItemType.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)	RatingItem	Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)	RatingItem	Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)	RatingItem	Ustawia liczbę punktów, jaką jest wart oceniany element.
setRatingIcon(ratingIcon)	RatingItem	Ustawia ikonę oceny.
setRatingScaleLevel(ratingScaleLevel)	RatingItem	Ustawia maksymalny poziom skali oceny.
setRequired(enabled)	RatingItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	RatingItem	Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Szczegółowa dokumentacja

createResponse(response)

Tworzy nowy ItemResponse dla tego elementu oceny.

Zgłasza wyjątek skryptu, jeśli podana wartość response jest mniejsza niż 1 lub większa niż wartość zwrócona przez getRatingScaleLevel().

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a 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 dla tego elementu oceny.

Powrót

ItemResponse – odpowiedź dotycząca elementu.

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

---

duplicate()

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Powrót

RatingItem – duplikat tego RatingItem 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

---

getGeneralFeedback()

Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.

Powrót

QuizFeedback – opinia (jeśli występuje).

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

---

getHelpText()

Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis produktu;

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

---

getId()

Pobiera unikalny identyfikator elementu.

Powrót

Integer – identyfikator produktu;

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

---

getIndex()

Pobiera indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

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

---

getPoints()

Zwraca wartość punktową elementu podlegającego ocenie.

Powrót

Integer – liczba punktów za pytanie.

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

---

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

---

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

---

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

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

---

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Powrót

ItemType – typ produktu

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

---

isRequired()

Określa, czy respondent musi odpowiedzieć na pytanie.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie.

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

---

setGeneralFeedback(feedback)

Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).

Parametry

Nazwa	Typ	Opis
feedback	QuizFeedback	nowa opinia

Powrót

RatingItem – ten RatingItem, do tworzenia łańcuszków

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

---

setHelpText(text)

Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
text	String	nowy tekst pomocy,

Powrót

RatingItem – ten RatingItem, do tworzenia łańcuszków

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

---

setPoints(points)

Ustawia liczbę punktów, jaką jest wart oceniany element. Wartość domyślna dla nowych elementów to 0.

Parametry

Nazwa	Typ	Opis
points	Integer	liczbę punktów, jaką można uzyskać za pytanie.

Powrót

RatingItem – ten RatingItem, do tworzenia łańcuszków

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

---

setRatingIcon(ratingIcon)

Ustawia ikonę oceny.

Zgłasza 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 – ten RatingItem do tworzenia łańcuszków.

Rzuty

Error – jeśli typ ikony oceny jest nieprawidłowy.

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

---

setRatingScaleLevel(ratingScaleLevel)

Ustawia maksymalny poziom skali oceny. Maksymalny poziom skali oceny musi mieścić się w zakresie od 3 do 10 włącznie. Nowa ocena ma domyślnie poziom skali ocen 3.

Zgłasza 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 – ten RatingItem do tworzenia łańcuszków.

Rzuty

Error – jeśli poziom skali ocen jest nieprawidłowy

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

---

setRequired(enabled)

Określa, czy respondent musi odpowiedzieć na pytanie.

Parametry

Nazwa	Typ	Opis
enabled	Boolean	czy respondent musi odpowiedzieć na pytanie;

Powrót

RatingItem – bieżący element (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

---

setTitle(title)

Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

Nazwa	Typ	Opis
title	String	nowy tytuł lub tekst nagłówka;

Powrót

RatingItem – ten RatingItem, do tworzenia łańcuszków

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