Class RatingItem

OcenaArtykuł

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ęcznego oceniania).
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 maksymalny poziom skali oceny.
setRequired(enabled)	RatingItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	RatingItem	Ustawia tytuł elementu (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 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 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()

Pobiera typ elementu jako ItemType.

Powrót

ItemType – typ 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

---

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ęcznego oceniania).

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 maksymalny poziom skali oceny. Maksymalny 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ł elementu (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