Class DateItem

DateItem

Element pytania, który umożliwia użytkownikowi wskazanie daty. Elementy można otworzyć lub utworzyć za pomocą Form. W przypadku testów te elementy są oceniane. 

// Open a form by ID and add a new date item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateItem();
item.setTitle('When were you born?');

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu daty.
duplicate()DateItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
includesYear()BooleanOkreśla, czy element daty zawiera opcję roku.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)DateItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setIncludesYear(enableYear)DateItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)DateItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)DateItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Szczegółowa dokumentacja

createResponse(response)

Tworzy nowy element ItemResponse dla tego elementu daty. Pola czasu obiektu Date są ignorowane. Domyślnie używane są tylko pola roku, miesiąca i dnia. Jeśli setIncludesYear(enabled) ma wartość false, rok również jest ignorowany.

Parametry

NazwaTypOpis
responseDateobiekt Date reprezentujący miesiąc, dzień i możliwe, że rok

Powroty

ItemResponse – odpowiedź dotycząca produktu,

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

duplicate()

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

Powroty

DateItem – duplikat elementu DateItem na potrzeby ł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

getGeneralFeedback()

Zwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.

Powroty

QuizFeedback – ewentualna opinia.

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

getHelpText()

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

Powroty

String – tekst pomocy lub opis dotyczący produktu.

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

getId()

Pobiera unikalny identyfikator elementu.

Powroty

Integer – identyfikator produktu,

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

getIndex()

Pobiera indeks elementu spośród wszystkich elementów formularza.

Powroty

Integer – indeks elementu;

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

getPoints()

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

Powroty

Integer – liczba punktów, za jaką pytanie jest warte 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

getTitle()

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

Powroty

String – tytuł lub tekst nagłówka elementu;

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

getType()

Pobiera typ elementu, reprezentowany jako ItemType.

Powroty

ItemType – typ elementu;

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

includesYear()

Określa, czy element daty zawiera opcję roku.

Powroty

Boolean – true, jeśli data zawiera ustawienie roku; w przeciwnym razie false

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

isRequired()

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Powroty

Boolean – czy użytkownik musi odpowiedzieć 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

setGeneralFeedback(feedback)

Określa informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powroty

DateItem – ten DateItem, do ł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

setHelpText(text)

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

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Powroty

DateItem – ten DateItem, do ł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

setIncludesYear(enableYear)

Określa, czy element daty zawiera ustawienie roku. Wartość domyślna nowych elementów daty to true.

Parametry

NazwaTypOpis
enableYearBooleantrue, jeśli data zawiera ustawienie roku; w przeciwnym razie false

Powroty

DateItem – ten DateItem, do ł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

setPoints(points)

Określa liczbę punktów za element, który można ocenić. Wartość domyślna nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów wartych pytania

Powroty

DateItem – ten DateItem, do ł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

setRequired(enabled)

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie,

Powroty

DateItem – bieżący element (na potrzeby łańcuszkó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

setTitle(title)

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

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powroty

DateItem – ten DateItem, do ł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