- Zasób: Formularz
- Informacje
- FormSettings
- QuizSettings
- Element
- QuestionItem
- Pytanie
- ChoiceQuestion
- ChoiceType
- Opcja
- GoToAction
- Obraz
- MediaProperties
- Wyrównanie
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Ocenianie
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Siatka
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Film
- Metody
Zasób: Form
dokument w Formularzach Google, Formularz zostaje utworzony na Dysku, a jego usunięcie lub zmiana zabezpieczeń dostępu odbywa się za pomocą interfejsu Drive API.
Zapis JSON |
---|
{ "formId": string, "info": { object ( |
Pola | |
---|---|
formId |
Tylko dane wyjściowe. Identyfikator formularza. |
info |
To pole jest wymagane. Tytuł i opis formularza. |
settings |
Ustawienia formularza. Należy ją zaktualizować wartością |
items[] |
To pole jest wymagane. Lista elementów formularza, które mogą obejmować nagłówki sekcji, pytania, osadzone multimedia itp. |
revisionId |
Tylko dane wyjściowe. Identyfikator wersji formularza. Używane w polu Format identyfikatora wersji może się z czasem zmieniać, dlatego należy go traktować nieprzezroczysty. Zwrócony identyfikator wersji jest ważny tylko przez 24 godziny od zwrócenia i nie może być udostępniany użytkownikom. Jeśli identyfikator wersji nie uległ zmianie między wywołaniami, formularz się nie zmienił. Natomiast zmiana identyfikatora (dla tego samego formularza i użytkownika) zwykle oznacza, że formularz został zaktualizowany. Zmiana może być jednak spowodowana czynnikami wewnętrznymi, takimi jak zmiana formatu identyfikatora. |
responderUri |
Tylko dane wyjściowe. Identyfikator URI formularza do udostępnienia użytkownikom. Otworzy się strona, na której użytkownik będzie mógł przesłać odpowiedzi, ale nie będzie mógł ich edytować. |
linkedSheetId |
Tylko dane wyjściowe. Identyfikator połączonego arkusza Google, który zbiera odpowiedzi z tego formularza (jeśli arkusz taki istnieje). |
Informacje
Ogólne informacje o formularzu.
Zapis JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Pola | |
---|---|
title |
To pole jest 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 dotyczące formularzy testów i oceniania. |
QuizSettings
Ustawienia dotyczące formularzy testów i oceniania. Należy je zaktualizować za pomocą obiektu UpdateSettingsRequest.
Zapis JSON |
---|
{ "isQuiz": boolean } |
Pola | |
---|---|
isQuiz |
Określa, czy formularz jest quizem. Jeśli tak, odpowiedzi są 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. Można go podać podczas tworzenia, ale nie można użyć identyfikatora w formularzu. Jeśli identyfikator nie zostanie podany, zostanie przypisany nowy identyfikator. |
title |
Tytuł produktu. |
description |
Opis produktu. |
Pole sumy kind . To pole jest wymagane. Rodzaj tego elementu. kind może być tylko jednym z tych elementów: |
|
questionItem |
Zadawanie pytania użytkownikowi. |
questionGroupItem |
Zadawanie użytkownikowi co najmniej 1 pytania w odpowiedzi na wiadomość główną. |
pageBreakItem |
Uruchamia nową stronę o nazwie. |
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 |
To pole jest wymagane. Wyświetlane pytanie. |
image |
Obraz wyświetlany w pytaniu. |
Question
Dowolne pytanie. Konkretny typ pytania jest nazywany kind
.
Zapis JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Pola | |
---|---|
questionId |
Tylko do odczytu. Identyfikator pytania. Można go podać podczas tworzenia, ale nie można użyć identyfikatora w formularzu. Jeśli identyfikator nie zostanie podany, zostanie przypisany nowy identyfikator. |
required |
Czy odpowiedź na pytanie jest wymagana, aby użytkownik mógł przesłać swoją odpowiedź. |
grading |
Konfiguracja oceniania pytania. |
Pole sumy kind . To pole jest wymagane. Rodzaj pytania zaproponowanego użytkownikowi. kind może mieć tylko jedną z tych wartości: |
|
choiceQuestion |
Użytkownik może wybrać jedną ze wstępnie zdefiniowanych opcji. |
textQuestion |
Użytkownik może wpisać własną odpowiedź tekstową. |
scaleQuestion |
Użytkownik może wybrać liczbę z zakresu. |
dateQuestion |
Użytkownik może wpisać datę. |
timeQuestion |
Użytkownik może wpisać godzinę. |
fileUploadQuestion |
Użytkownik może przesłać jeden lub wiele plików. |
rowQuestion |
Wiersz elementu |
ChoiceQuestion
Pytanie z opcjami wyboru lub polem wyboru.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
To pole jest wymagane. Rodzaj pytania jednokrotnego wyboru. |
options[] |
To pole jest wymagane. Lista opcji, które użytkownik musi wybrać. |
shuffle |
Określa, czy opcje powinny wyświetlać się w losowej kolejności w przypadku różnych wystąpień testu. Takie działanie jest często stosowane, aby zapobiegać oszustwom przez respondentów, którzy patrzą na ekran innego użytkownika, lub przeciwdziałać stronniczości w ankiecie, która może być wprowadzana przez ustawianie 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 może wybrać tylko jedną z nich. |
CHECKBOX |
Pola wyboru: użytkownik widzi wszystkie opcje, z których może wybrać dowolną liczbę. |
DROP_DOWN |
Menu: wybór jest wyświetlany tylko użytkownikowi na żądanie lub tylko aktualny. Można wybrać tylko jedną opcję. |
Option
Opcja dla pytania jednokrotnego wyboru.
Zapis JSON |
---|
{ "value": string, "image": { object ( |
Pola | |
---|---|
value |
To pole jest wymagane. Wybór przedstawiony użytkownikowi. |
image |
Wyświetl obraz jako opcję. |
isOther |
Wskazuje, czy opcja ma wartość „Inne”. Obecnie dotyczy tylko typów wyboru |
Pole sumy go_to_section . Sekcja, do której ma przejść po wybraniu tej opcji. Obecnie ma zastosowanie tylko do wyboru typu RADIO i SELECT , ale nie jest dozwolony w typie QuestionGroupItem . go_to_section może mieć tylko jedną z tych wartości: |
|
goToAction |
Typ nawigacji po sekcji. |
goToSectionId |
Identyfikator elementu z nagłówka sekcji, do którego prowadzi. |
GoToAction
Stałe do nawigacji po sekcjach.
Wartości w polu enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
NEXT_SECTION |
Przejdź do następnej sekcji. |
RESTART_FORM |
Wróć do początku formularza. |
SUBMIT_FORM |
Prześlij formularz natychmiast. |
Obraz
Dane przedstawiają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. Jest on ważny 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 należy ustawić dokładnie jedno pole źródłowe. image_source może mieć tylko jedną z tych wartości: |
|
sourceUri |
Tylko dane wejściowe. Źródłowy identyfikator URI to identyfikator URI używany do wstawienia 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. Podczas wyświetlania multimediów są one skalowane do mniejszej wartości lub do szerokości wyświetlanego formularza. Oryginalny format obrazu zostanie zachowany. Jeśli szerokość nie jest określona podczas dodawania multimediów do formularza, jest ona ustawiana 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ślonej 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 jest to krótkie pytanie tekstowe. |
ScaleQuestion
Pytanie dot. skali. Użytkownik ma do wyboru zakres wartości liczbowych.
Zapis JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Pola | |
---|---|
low |
To pole jest wymagane. Najniższa możliwa wartość dla skali. |
high |
To pole jest wymagane. Najwyższa możliwa wartość dla skali. |
lowLabel |
Etykieta do wyświetlenia opisująca najniższy punkt skali. |
highLabel |
Etykieta do wyświetlenia opisująca najwyższy punkt na skali. |
DateQuestion
Pytanie dotyczące daty. Pytania dotyczące dat domyślnie podają tylko miesiąc i dzień.
Zapis JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Pola | |
---|---|
includeTime |
Czy uwzględnić czas w pytaniu. |
includeYear |
Czy dodać rok do pytania. |
TimeQuestion
Pytanie o czas.
Zapis JSON |
---|
{ "duration": boolean } |
Pola | |
---|---|
duration |
|
FileUploadQuestion
Pytanie z możliwością przesyłania plików. Interfejs API obecnie nie obsługuje tworzenia pytań z możliwością przesyłania plików.
Zapis JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Pola | |
---|---|
folderId |
To pole jest 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 jednej odpowiedzi na to pytanie. |
maxFileSize |
Maksymalna dozwolona liczba bajtów w przypadku pojedynczego pliku przesłanego do tego pytania. |
FileType
Typy plików, które można przesłać do pytania z możliwością przesyłania plików.
Wartości w polu enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
Wartość domyślna. Nieużywane. |
ANY |
Brak ograniczeń typu. |
DOCUMENT |
Dokument Google. |
PRESENTATION |
Prezentacja w Prezentacjach Google. |
SPREADSHEET |
Arkusz kalkulacyjny Arkuszy Google. |
DRAWING |
Rysunek. |
PDF |
Plik PDF. |
IMAGE |
Obraz. |
VIDEO |
Film. |
AUDIO |
Plik audio. |
RowQuestion
Konfiguracja pytania należącego do grupy pytań.
Zapis JSON |
---|
{ "title": string } |
Pola | |
---|---|
title |
To pole jest wymagane. Tytuł pojedynczego wiersza w kolumnie |
Ocenianie
Ocenianie jednego pytania
Zapis JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Pola | |
---|---|
pointValue |
To pole jest wymagane. Maksymalna liczba punktów, które użytkownik może automatycznie otrzymać za poprawną odpowiedź. Ta wartość nie może być liczbą ujemną. |
correctAnswers |
To pole jest wymagane. Klucz odpowiedzi na pytanie. Odpowiedzi są oceniane automatycznie na podstawie tego pola. |
whenRight |
Komentarze wyświetlane przy poprawnych odpowiedziach. Tę opinię można skonfigurować tylko dla pytań jednokrotnego wyboru z prawidłowymi odpowiedziami. |
whenWrong |
Komentarz wyświetlany w przypadku nieprawidłowych odpowiedzi. Tę opinię można skonfigurować tylko dla pytań jednokrotnego wyboru z prawidłowymi odpowiedziami. |
generalFeedback |
Opinia wyświetlana przy wszystkich odpowiedziach. Tego formatu często używa się w przypadku pytań z krótką odpowiedzią, gdy właściciel testu chce szybko dać użytkownikom poczucie, że odpowiedzieli na pytanie prawidłowo, zanim oficjalnie ocenią odpowiedź. W przypadku automatycznie ocenianych pytań jednokrotnego wyboru nie można dodać opinii ogólnej. |
CorrectAnswers
Klucz odpowiedzi na pytanie.
Zapis JSON |
---|
{
"answers": [
{
object ( |
Pola | |
---|---|
answers[] |
Lista poprawnych odpowiedzi. Na podstawie tych odpowiedzi odpowiedzi na pytania mogą być automatycznie oceniane. W przypadku pytań jednowartościowych odpowiedź jest oznaczana jako prawidłowa, jeśli pasuje do którejkolwiek wartości z tej listy (inaczej mówiąc, może być kilka poprawnych odpowiedzi). W przypadku pytań wielowartościowych ( |
CorrectAnswer
Jedna poprawna odpowiedź na pytanie. W przypadku pytań wielowartościowych (CHECKBOX
) do określenia jednej prawidłowej opcji odpowiedzi można potrzebować kilku elementów CorrectAnswer
.
Zapis JSON |
---|
{ "value": string } |
Pola | |
---|---|
value |
To pole jest wymagane. Prawidłowa wartość odpowiedzi. Szczegółowe informacje o formatowaniu różnych typów wartości znajdziesz w dokumentacji właściwości |
QuestionGroupItem
Definiuje pytanie składające się z kilku pytań zgrupowanych.
Zapis JSON |
---|
{ "questions": [ { object ( |
Pola | |
---|---|
questions[] |
To pole jest wymagane. Lista pytań należących do tej grupy. Pytanie może należeć tylko do jednej grupy. Ustawienie |
image |
Obraz wyświetlany w grupie pytań nad konkretnymi pytaniami. |
Pole sumy kind . To pole jest wymagane. Rodzaj grupy pytań, który określa, jakie typy pytań są dozwolone i w jaki sposób są one wyświetlane. kind może mieć tylko jedną z tych wartości: |
|
grid |
Grupa pytań jest siatką z wierszami pytań jednokrotnego wyboru, które zawierają te same opcje. Jeśli zasada |
Siatka
Siatka odpowiedzi (pole wyboru lub pola wyboru), przy czym każdy wiersz odpowiada osobnemu pytaniu. Każdy wiersz zawiera te same opcje, które są widoczne jako kolumny.
Zapis JSON |
---|
{
"columns": {
object ( |
Pola | |
---|---|
columns |
To pole jest wymagane. Opcje wspólne dla każdego pytania w siatce. Inaczej mówiąc, wartości kolumn. Dozwolone są tylko opcje |
shuffleQuestions |
Jeśli wybierzesz |
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 |
To pole jest wymagane. Obraz wyświetlany w elemencie. |
VideoItem
Element zawierający film.
Zapis JSON |
---|
{
"video": {
object ( |
Pola | |
---|---|
video |
To pole jest 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 |
To pole jest wymagane. Identyfikator URI YouTube. |
properties |
Właściwości filmu. |
Metody |
|
---|---|
|
Wprowadź zmiany w formularzu partiami aktualizacji. |
|
Utwórz nowy formularz, korzystając z tytułu podanego w wiadomości w formularzu. |
|
Pobierz formularz. |