Class DateTimeItem

DataCzasProdukt

Element pytania, który umożliwia respondentowi wskazanie daty i godziny. Elementy można tworzyć i do nich uzyskiwać dostęp z poziomu Form. Gdy są używane w teście, są oceniane. 

// Open a form by ID and add a new date-time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu daty i godziny.
duplicate()DateTimeItemTworzy 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, PageBreakItems i SectionHeaderItems).
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ć.
getTitle()StringPobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu jako ItemType.
includesYear()BooleanOkreśla, czy element data zawiera opcję roku.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateTimeItemOkreś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)DateTimeItemUstawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateTimeItemOkreśla liczbę punktów, które można przyznać ocenianemu elementowi.
setRequired(enabled)DateTimeItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)DateTimeItemUstawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Szczegółowa dokumentacja

createResponse(response)

Tworzy nowy element ItemResponse dla tego elementu daty i godziny. Pole sekund obiektu Date jest ignorowane. Domyślnie używane są pola rok, miesiąc, dzień, godzina i minuta. Jeśli setIncludesYear(enabled) ma wartość false, rok jest też ignorowany.

Parametry

NazwaTypOpis
responseDateobiekt Date reprezentujący miesiąc, dzień, godzinę, minutę i ewentualnie rok

Powrót

ItemResponse – odpowiedź na element

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

DateTimeItem – duplikat tego elementu DateTimeItem, 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

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

includesYear()

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

Powrót

Boolean – true, jeśli data zawiera ustawienie roku; false, jeśli nie

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

NazwaTypOpis
feedbackQuizFeedbacknowe opinie

Powrót

DateTimeItem – ta DateTimeItem, 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

NazwaTypOpis
textStringnowy tekst pomocy.

Powrót

DateTimeItem – ta DateTimeItem, 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

setIncludesYear(enableYear)

Określa, czy element daty zawiera ustawienie roku. Domyślna wartość dla nowych elementów daty to true.

Parametry

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

Powrót

DateTimeItem – ta DateTimeItem, 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

DateTimeItem – ta DateTimeItem, 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

setRequired(enabled)

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

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi udzielić odpowiedzi na pytanie.

Powrót

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

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powrót

DateTimeItem – ta DateTimeItem, 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