- Zasób: Formularz
- Informacje
- FormSettings
- QuizSettings
- Element
- QuestionItem
- Pytanie
- ChoiceQuestion
- ChoiceType
- Opcja
- GoToAction
- Obrazy
- MediaProperties
- Dopasowanie
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Ocenianie
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Siatka
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Film
- Metody
Zasób: formularz
Dokument z Formularzy Google. Formularz jest tworzony na Dysku. Aby usunąć formularz lub zmienić jego zabezpieczenia przed dostępem, użyj interfejsu Drive API.
Zapis JSON |
---|
{ "formId": string, "info": { object ( |
Pola | |
---|---|
formId |
Tylko dane wyjściowe. Identyfikator formularza. |
info |
Wymagane. Tytuł i opis formularza. |
settings |
Ustawienia formularza. Musisz zaktualizować ten atrybut za pomocą atrybutu |
items[] |
Wymagane. Lista elementów formularza, która może obejmować nagłówki sekcji, pytania, umieszczone multimedia itp. |
revisionId |
Tylko dane wyjściowe. Identyfikator wersji formularza. Używana w elemencie Format identyfikatora wersji może się z czasem zmieniać, dlatego identyfikator powinien być nieprzezroczysty. Gwarantujemy, że zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny po zwróceniu i nie będzie można go udostępniać użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, formularz się nie zmienił. Natomiast zmiana identyfikatora (dla tego samego formularza i użytkownika) oznacza zazwyczaj, że formularz został zaktualizowany. ale z powodu czynników wewnętrznych, takich jak zmiana formatu identyfikatora. |
responderUri |
Tylko dane wyjściowe. Identyfikator URI formularza, który ma być udostępniany użytkownikom. Otworzy się strona, na której użytkownik może przesyłać odpowiedzi, ale nie może ich edytować. |
linkedSheetId |
Tylko dane wyjściowe. Identyfikator połączonego arkusza Google, który zbiera odpowiedzi z tego formularza (jeśli taki arkusz istnieje). |
Informacje
Ogólne informacje o formularzu.
Zapis JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Pola | |
---|---|
title |
Wymagane. Tytuł formularza widoczny dla użytkowników. |
documentTitle |
Tylko dane wyjściowe. Tytuł dokumentu widoczny na Dysku. Jeśli pole |
description |
Opis formularza. |
FormSettings
Ustawienia formularza.
Zapis JSON |
---|
{
"quizSettings": {
object ( |
Pola | |
---|---|
quizSettings |
Ustawienia związane z formularzami testów i ocenianiem. |
QuizSettings
Ustawienia związane z formularzami testów i ocenianiem. Należy je zaktualizować za pomocą obiektu UpdateSettingsRequest.
Zapis JSON |
---|
{ "isQuiz": boolean } |
Pola | |
---|---|
isQuiz |
Określa, czy ten formularz jest quizem. Jeśli ustawisz wartość prawda, odpowiedzi będą oceniane na podstawie pytania |
Element
Pojedynczy element formularza. kind
określa rodzaj produktu.
Zapis JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Pola | |
---|---|
itemId |
Identyfikator produktu. Identyfikator można podać podczas tworzenia, ale nie może on być już użyty w formularzu. Jeśli nie zostanie podany, zostanie przypisany nowy identyfikator. |
title |
Tytuł produktu. |
description |
Opis produktu. |
Pole sumy kind . Wymagane. Rodzaj danego elementu. kind może mieć tylko jedną z tych wartości: |
|
questionItem |
Zadawanie użytkownikowi pytania |
questionGroupItem |
Zadaje użytkownikowi co najmniej 1 pytanie przy użyciu jednego głównego promptu. |
pageBreakItem |
Rozpoczyna nową stronę pod tytułem. |
textItem |
Wyświetla tytuł i opis na stronie. |
imageItem |
Wyświetla obraz na stronie. |
videoItem |
Wyświetla film na stronie. |
QuestionItem
Element formularza zawierający jedno pytanie.
Zapis JSON |
---|
{ "question": { object ( |
Pola | |
---|---|
question |
Wymagane. Wyświetlane pytanie. |
image |
Obraz wyświetlany w pytaniu. |
Pytanie
Jakieś pytania. Konkretny typ pytania to kind
.
Zapis JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Pola | |
---|---|
questionId |
Tylko do odczytu. Identyfikator pytania. Identyfikator można podać podczas tworzenia, ale nie może on być już użyty w formularzu. Jeśli nie zostanie podany, zostanie przypisany nowy identyfikator. |
required |
Określa, czy użytkownik musi udzielić odpowiedzi na pytanie, aby użytkownik mógł przesłać odpowiedź. |
grading |
Konfiguracja oceniania dla tego pytania. |
Pole sumy kind . Wymagane. Rodzaj pytania zadanego respondentowi. kind może mieć tylko jedną z tych wartości: |
|
choiceQuestion |
Użytkownik może wybierać ze wstępnie zdefiniowanych opcji. |
textQuestion |
Użytkownik może wpisać odpowiedź tekstową. |
scaleQuestion |
Użytkownik może wybrać liczbę z zakresu. |
dateQuestion |
Użytkownik może podać datę. |
timeQuestion |
Użytkownik może podać godzinę. |
fileUploadQuestion |
Użytkownik może przesłać jeden lub więcej plików. |
rowQuestion |
Wiersz elementu |
ChoiceQuestion
Pytanie radiowe/pytanie w polu wyboru lub menu.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Wymagane. Typ pytania jednokrotnego wyboru. |
options[] |
Wymagane. Lista opcji, które użytkownik musi wybrać. |
shuffle |
Określa, czy opcje mają być wyświetlane w losowej kolejności w różnych przypadkach testu. Często używa się go, aby zapobiegać oszustwom przez respondentów, którzy patrzą na ekran innego respondenta, lub rozwiązywać problemy z uprzedzeniami w ankiecie, które mogą wynikać z umieszczania zawsze tych samych opcji na początku lub na końcu. |
ChoiceType
Typ wyboru.
Wartości w polu enum | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
RADIO |
Przyciski opcji: użytkownik widzi wszystkie opcje i może wybrać tylko jedną z nich. |
CHECKBOX |
Pola wyboru: użytkownik widzi wszystkie opcje i może wybrać dowolną ich liczbę. |
DROP_DOWN |
Menu: opcje są widoczne tylko dla użytkownika na żądanie. W przeciwnym razie widoczny jest tylko bieżący wybór. Możesz wybrać tylko jedną opcję. |
Opcja
Odpowiedź na pytanie wyboru.
Zapis JSON |
---|
{ "value": string, "image": { object ( |
Pola | |
---|---|
value |
Wymagane. Wybór przedstawiony użytkownikowi. |
image |
Wyświetl obraz jako opcję. |
isOther |
Określa, czy opcja ma wartość „Inne”. Obecnie dotyczy to tylko typów wyboru |
Pole sumy go_to_section . Sekcja, do której należy przejść po wybraniu tej opcji. Obecnie dotyczy to tylko typu wyboru RADIO i SELECT , ale nie jest to dozwolone w QuestionGroupItem . go_to_section może mieć tylko jedną z tych wartości: |
|
goToAction |
Typ nawigacji po sekcji. |
goToSectionId |
Identyfikator elementu nagłówka sekcji, do której należy przejść. |
GoToAction
Stałe związane z nawigacją po sekcji.
Wartości w polu enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
NEXT_SECTION |
Przejdź do następnej sekcji. |
RESTART_FORM |
Wróć na początek formularza. |
SUBMIT_FORM |
Natychmiast prześlij formularz. |
Obraz
Dane reprezentujące obraz.
Zapis JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Pola | |
---|---|
contentUri |
Tylko dane wyjściowe. identyfikator URI, z którego można pobrać obraz; informacje są ważne tylko przez ograniczony czas. |
altText |
Opis obrazu wyświetlany po najechaniu kursorem i odczytywany przez czytniki ekranu. |
properties |
Właściwości obrazu. |
Pole sumy image_source . Rodzaj źródła obrazu. Podczas tworzenia nowych obrazów musisz ustawić dokładnie 1 pole źródłowe obrazu. image_source może mieć tylko jedną z tych wartości: |
|
sourceUri |
Tylko dane wejściowe. Identyfikator URI źródła to identyfikator URI służący do wstawiania obrazu. Źródłowy identyfikator URI może być pusty po pobraniu. |
MediaProperties
Właściwości multimediów.
Zapis JSON |
---|
{
"alignment": enum ( |
Pola | |
---|---|
alignment |
Pozycja multimediów. |
width |
Szerokość multimediów w pikselach. Gdy multimedia są wyświetlane, są skalowane do mniejszej z tych wartości lub szerokości wyświetlanego formularza. Oryginalny format obrazu jest zachowywany. Jeśli szerokość nie zostanie określona przy dodawaniu multimediów do formularza, zostanie ona ustawiona na szerokość źródła multimediów. Szerokość musi mieścić się w zakresie od 0 do 740 włącznie. Ustawienie szerokości na 0 lub nieokreślenia wartości jest dozwolone tylko podczas aktualizowania źródła multimediów. |
Wyrównanie
Wyrównanie na stronie.
Wartości w polu enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
LEFT |
Wyrównaj do lewej. |
RIGHT |
Wyrównaj do prawej. |
CENTER |
Na środku. |
TextQuestion
Pytanie tekstowe.
Zapis JSON |
---|
{ "paragraph": boolean } |
Pola | |
---|---|
paragraph |
Określa, czy pytanie jest akapitem czy nie. W przeciwnym razie pytanie ma postać krótkiego tekstu. |
ScaleQuestion
Pytanie na skalę. Do wyboru jest szereg wartości liczbowych.
Zapis JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Pola | |
---|---|
low |
Wymagane. Najniższa możliwa wartość dla skali. |
high |
Wymagane. Najwyższa możliwa wartość na skali. |
lowLabel |
Wyświetlana etykieta opisująca najniższy punkt na skali. |
highLabel |
Wyświetlana etykieta opisująca najwyższy punkt na skali. |
DateQuestion
Pytanie dotyczące daty. Pytania dotyczące daty są domyślnie ustawione tylko na miesiąc i dzień.
Zapis JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Pola | |
---|---|
includeTime |
Określa, czy w pytaniu należy podać godzinę. |
includeYear |
Określa, czy w pytaniu należy podać rok. |
TimeQuestion
Pytanie dotyczące czasu.
Zapis JSON |
---|
{ "duration": boolean } |
Pola | |
---|---|
duration |
|
FileUploadQuestion
Pytanie z przesyłaniem pliku. Interfejs API nie obsługuje obecnie tworzenia pytań z możliwością przesyłania plików.
Zapis JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Pola | |
---|---|
folderId |
Wymagane. Identyfikator folderu na Dysku, w którym są przechowywane przesłane pliki. |
types[] |
Typy plików akceptowane w tym pytaniu. |
maxFiles |
Maksymalna liczba plików, które można przesłać w przypadku tego pytania w ramach jednej odpowiedzi. |
maxFileSize |
Maksymalna dozwolona liczba bajtów dla jednego pliku przesłanego w ramach tego pytania. |
FileType
Typy plików, które można przesłać w pytaniu dotyczącym przesyłania plików.
Wartości w polu enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
ANY |
Brak ograniczeń dotyczących typu. |
DOCUMENT |
Dokument w Dokumentach Google. |
PRESENTATION |
Prezentacja Google. |
SPREADSHEET |
Arkusz kalkulacyjny Arkuszy Google. |
DRAWING |
Rysunek. |
PDF |
Plik PDF. |
IMAGE |
Obraz. |
VIDEO |
Film. |
AUDIO |
Plik audio. |
RowQuestion
Konfiguracja pytania, które należy do grupy pytań.
Zapis JSON |
---|
{ "title": string } |
Pola | |
---|---|
title |
Wymagane. Tytuł pojedynczego wiersza w kolumnie |
Ocenianie
Ocena pojedynczego pytania
Zapis JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Pola | |
---|---|
pointValue |
Wymagane. Maksymalna liczba punktów, które użytkownik może automatycznie zdobyć za prawidłową odpowiedź. Wartość nie może być liczbą ujemną. |
correctAnswers |
Wymagane. Klucz odpowiedzi na pytanie. Odpowiedzi są oceniane automatycznie na podstawie tego pola. |
whenRight |
Komentarz wyświetlany dla poprawnych odpowiedzi. Tę opinię można ustawić tylko dla pytania jednokrotnego wyboru, na które podano poprawne odpowiedzi. |
whenWrong |
Opinia wyświetlana przy nieprawidłowych odpowiedziach. Tę opinię można ustawić tylko dla pytania jednokrotnego wyboru, na które podano poprawne odpowiedzi. |
generalFeedback |
Komentarz wyświetlany przy wszystkich odpowiedziach. Jest to często stosowane w przypadku pytań z krótkimi odpowiedziami, gdy właściciel testu chce szybko dać użytkownikom poczucie, że odpowiedź jest poprawna, zanim jeszcze oficjalnie ocenili odpowiedź. Nie można ustawić opinii ogólnej w przypadku automatycznie ocenianych pytań jednokrotnego wyboru. |
CorrectAnswers
Klucz odpowiedzi na pytanie.
Zapis JSON |
---|
{
"answers": [
{
object ( |
Pola | |
---|---|
answers[] |
Lista prawidłowych odpowiedzi. Odpowiedzi w quizie mogą być oceniane automatycznie na podstawie tych odpowiedzi. W przypadku pytań jednowartościowych odpowiedź jest oznaczana jako prawidłowa, jeśli pasuje do dowolnej wartości z tej listy (inaczej mówiąc, możliwe jest kilka poprawnych odpowiedzi). W przypadku pytań z wieloma wartościami ( |
CorrectAnswer
Jedna prawidłowa odpowiedź na pytanie. W przypadku pytań z wieloma wartościami (CHECKBOX
) do reprezentowania jednej poprawnej odpowiedzi może być potrzebne kilka znaczników CorrectAnswer
.
Zapis JSON |
---|
{ "value": string } |
Pola | |
---|---|
value |
Wymagane. Wartość prawidłowej odpowiedzi. Szczegółowe informacje o formatowaniu różnych typów wartości znajdziesz w dokumentacji usługi |
QuestionGroupItem
Definiuje pytanie składające się z wielu zgrupowanych pytań.
Zapis JSON |
---|
{ "questions": [ { object ( |
Pola | |
---|---|
questions[] |
Wymagane. Lista pytań należących do tej grupy pytań. Pytanie może należeć tylko do jednej grupy. |
image |
Obraz wyświetlany w grupie pytań nad konkretnymi pytaniami. |
Pole sumy kind . Wymagane. Typ grupy pytań określający dozwolone typy pytań i sposób ich wyświetlania. kind może mieć tylko jedną z tych wartości: |
|
grid |
Grupa pytań to siatka z wierszami pytań jednokrotnego wyboru, które mają te same opcje. Jeśli zasada |
Siatka
Siatka opcji (radio lub pola wyboru), z których każdy wiersz stanowi osobne pytanie. Każdy wiersz zawiera te same opcje, które są wyświetlane jako kolumny.
Zapis JSON |
---|
{
"columns": {
object ( |
Pola | |
---|---|
columns |
Wymagane. Odpowiedzi na każde pytanie w siatce. Inaczej mówiąc, wartości w kolumnach. Dozwolone są tylko opcje |
shuffleQuestions |
Jeśli parametr ma wartość |
PageBreakItem
Podział strony. Tytuł i opis tego elementu są wyświetlane u góry nowej strony.
TextItem
Element tekstowy.
ImageItem
Element zawierający obraz.
Zapis JSON |
---|
{
"image": {
object ( |
Pola | |
---|---|
image |
Wymagane. Obraz wyświetlany w produkcie. |
VideoItem
Element zawierający film.
Zapis JSON |
---|
{
"video": {
object ( |
Pola | |
---|---|
video |
Wymagane. Film wyświetlany w elemencie. |
caption |
Tekst wyświetlany pod filmem. |
Wideo
Dane reprezentujące film.
Zapis JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Pola | |
---|---|
youtubeUri |
Wymagane. Identyfikator URI YouTube. |
properties |
Właściwości filmu. |
Metody |
|
---|---|
|
Wprowadź w formularzu serię aktualizacji. |
|
Utwórz nowy formularz, używając tytułu podanego w wiadomości formularza w prośbie. |
|
Pobierz formularz. |