REST Resource: forms

{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}

string

Tylko dane wyjściowe. Identyfikator formularza.

object (Info)

Wymagane. Tytuł i opis formularza.

object (FormSettings)

Ustawienia formularza. Musisz zaktualizować ten atrybut za pomocą atrybutu UpdateSettingsRequest; jest ignorowany podczas: forms.create i UpdateFormInfoRequest.

object (Item)

Wymagane. Lista elementów formularza, która może obejmować nagłówki sekcji, pytania, umieszczone multimedia itp.

string

Tylko dane wyjściowe. Identyfikator wersji formularza. Używana w elemencie WriteControl w żądaniach aktualizacji do identyfikowania wersji, na której są oparte zmiany.

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.

string

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ć.

string

Tylko dane wyjściowe. Identyfikator połączonego arkusza Google, który zbiera odpowiedzi z tego formularza (jeśli taki arkusz istnieje).

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

Wymagane. Tytuł formularza widoczny dla użytkowników.

string

Tylko dane wyjściowe. Tytuł dokumentu widoczny na Dysku. Jeśli pole Info.title jest puste, zamiast tekstu w interfejsie Formularzy Google może pojawić się właściwość documentTitle. Będzie ona widoczna dla użytkowników. Pole documentTitle można ustawić podczas tworzenia, ale nie można go zmodyfikować za pomocą żądania wsadowego. Aby automatycznie zaktualizować documentTitle, użyj interfejsu Google Drive API.

string

Opis formularza.

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

Ustawienia związane z formularzami testów i ocenianiem.

{
  "isQuiz": boolean
}

boolean

Określa, czy ten formularz jest quizem. Jeśli ustawisz wartość prawda, odpowiedzi będą oceniane na podstawie pytania Grading. Jeśli zasada ma wartość Fałsz, wszystkie pytania Grading są usuwane.

{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}

string

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.

string

Tytuł produktu.

string

Opis produktu.

object (QuestionItem)

Zadawanie użytkownikowi pytania

object (QuestionGroupItem)

Zadaje użytkownikowi co najmniej 1 pytanie przy użyciu jednego głównego promptu.

object (PageBreakItem)

Rozpoczyna nową stronę pod tytułem.

object (TextItem)

Wyświetla tytuł i opis na stronie.

object (ImageItem)

Wyświetla obraz na stronie.

object (VideoItem)

Wyświetla film na stronie.

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

Wymagane. Wyświetlane pytanie.

object (Image)

Obraz wyświetlany w pytaniu.

{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  }
  // End of list of possible types for union field kind.
}

string

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.

boolean

Określa, czy użytkownik musi udzielić odpowiedzi na pytanie, aby użytkownik mógł przesłać odpowiedź.

object (Grading)

Konfiguracja oceniania dla tego pytania.

object (ChoiceQuestion)

Użytkownik może wybierać ze wstępnie zdefiniowanych opcji.

object (TextQuestion)

Użytkownik może wpisać odpowiedź tekstową.

object (ScaleQuestion)

Użytkownik może wybrać liczbę z zakresu.

object (DateQuestion)

Użytkownik może podać datę.

object (TimeQuestion)

Użytkownik może podać godzinę.

object (FileUploadQuestion)

Użytkownik może przesłać jeden lub więcej plików.

object (RowQuestion)

Wiersz elementu QuestionGroupItem.

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

Wymagane. Typ pytania jednokrotnego wyboru.

object (Option)

Wymagane. Lista opcji, które użytkownik musi wybrać.

boolean

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.

{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}

string

Wymagane. Wybór przedstawiony użytkownikowi.

object (Image)

Wyświetl obraz jako opcję.

boolean

Określa, czy opcja ma wartość „Inne”. Obecnie dotyczy to tylko typów wyboru RADIO i CHECKBOX, ale nie jest to dozwolone w QuestionGroupItem.

enum (GoToAction)

Typ nawigacji po sekcji.

string

Identyfikator elementu nagłówka sekcji, do której należy przejść.

{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}

string

Tylko dane wyjściowe. identyfikator URI, z którego można pobrać obraz; informacje są ważne tylko przez ograniczony czas.

string

Opis obrazu wyświetlany po najechaniu kursorem i odczytywany przez czytniki ekranu.

object (MediaProperties)

Właściwości obrazu.

string

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.

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

Pozycja multimediów.

integer

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.

{
  "paragraph": boolean
}

boolean

Określa, czy pytanie jest akapitem czy nie. W przeciwnym razie pytanie ma postać krótkiego tekstu.

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

Wymagane. Najniższa możliwa wartość dla skali.

integer

Wymagane. Najwyższa możliwa wartość na skali.

string

Wyświetlana etykieta opisująca najniższy punkt na skali.

string

Wyświetlana etykieta opisująca najwyższy punkt na skali.

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

Określa, czy w pytaniu należy podać godzinę.

boolean

Określa, czy w pytaniu należy podać rok.

{
  "duration": boolean
}

boolean

true, jeśli pytanie dotyczy czasu, który upłynął. W przeciwnym razie chodzi o porę dnia.

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

Wymagane. Identyfikator folderu na Dysku, w którym są przechowywane przesłane pliki.

enum (FileType)

Typy plików akceptowane w tym pytaniu.

integer

Maksymalna liczba plików, które można przesłać w przypadku tego pytania w ramach jednej odpowiedzi.

string (int64 format)

Maksymalna dozwolona liczba bajtów dla jednego pliku przesłanego w ramach tego pytania.

{
  "title": string
}

string

Wymagane. Tytuł pojedynczego wiersza w kolumnie QuestionGroupItem.

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

Wymagane. Maksymalna liczba punktów, które użytkownik może automatycznie zdobyć za prawidłową odpowiedź. Wartość nie może być liczbą ujemną.

object (CorrectAnswers)

Wymagane. Klucz odpowiedzi na pytanie. Odpowiedzi są oceniane automatycznie na podstawie tego pola.

object (Feedback)

Komentarz wyświetlany dla poprawnych odpowiedzi. Tę opinię można ustawić tylko dla pytania jednokrotnego wyboru, na które podano poprawne odpowiedzi.

object (Feedback)

Opinia wyświetlana przy nieprawidłowych odpowiedziach. Tę opinię można ustawić tylko dla pytania jednokrotnego wyboru, na które podano poprawne odpowiedzi.

object (Feedback)

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.

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

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 (CHECKBOX) odpowiedź jest oznaczana jako prawidłowa, jeśli zawiera dokładnie wartości z tej listy.

{
  "value": string
}

string

Wymagane. Wartość prawidłowej odpowiedzi. Szczegółowe informacje o formatowaniu różnych typów wartości znajdziesz w dokumentacji usługi TextAnswer.value.

{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}

object (Question)

Wymagane. Lista pytań należących do tej grupy pytań. Pytanie może należeć tylko do jednej grupy. kind grupy może mieć wpływ na to, jakie typy pytań są dozwolone.

object (Image)

Obraz wyświetlany w grupie pytań nad konkretnymi pytaniami.

object (Grid)

Grupa pytań to siatka z wierszami pytań jednokrotnego wyboru, które mają te same opcje. Jeśli zasada grid jest ustawiona, wszystkie pytania w grupie muszą mieć rodzaj row.

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

Wymagane. Odpowiedzi na każde pytanie w siatce. Inaczej mówiąc, wartości w kolumnach. Dozwolone są tylko opcje CHECK_BOX i RADIO.

boolean

Jeśli parametr ma wartość true, pytania są uporządkowane losowo. Oznacza to, że wiersze są wyświetlane w innej kolejności dla każdego respondenta.

{
  "image": {
    object (Image)
  }
}

object (Image)

Wymagane. Obraz wyświetlany w produkcie.

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

Wymagane. Film wyświetlany w elemencie.

string

Tekst wyświetlany pod filmem.

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

Wymagane. Identyfikator URI YouTube.

object (MediaProperties)

Właściwości filmu.