Class RatingItem

RatingItem

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

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu oceny.
duplicate()RatingItemTworzy kopię tego elementu i dodaje ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator produktu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów za element, który można ocenić.
getRatingIcon()RatingIconTypePobiera ikonę wybraną dla oceny.
getRatingScaleLevel()IntegerPobiera poziom skali oceny.
getTitle()StringPobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu jako ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)RatingItemOkreś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)RatingItemUstawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)RatingItemOkreśla liczbę punktów, które można przyznać ocenianemu elementowi.
setRatingIcon(ratingIcon)RatingItemUstawia ikonę oceny.
setRatingScaleLevel(ratingScaleLevel)RatingItemUstawia poziom skali oceny.
setRequired(enabled)RatingItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)RatingItemUstawia 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

NazwaTypOpis
responseIntegerWartość 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, PageBreakItemsSectionHeaderItems).

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ęcznej oceny).

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowe 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, PageBreakItemsSectionHeaderItems).

Parametry

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

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

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

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

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

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