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 parametr za pomocą wartości UpdateSettingsRequest; jest on ignorowany podczas forms.create i UpdateFormInfoRequest.

object (Item)

Wymagane. Lista elementów formularza, która może zawierać nagłówki sekcji, pytania, osadzone treści multimedialne itp.

string

Tylko dane wyjściowe. Identyfikator wersji formularza. Używany w prośbach o aktualizację w polu WriteControl do identyfikowania wersji, na której bazują zmiany.

Format identyfikatora wersji może się z czasem zmieniać, dlatego należy traktować go jako nieprzezroczysty. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator poprawki nie zmienia się między wywołaniami, oznacza to, że formularz się nie zmienił. Zmiana identyfikatora (w przypadku tego samego formularza i użytkownika) zwykle oznacza, że formularz został zaktualizowany. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, takimi jak zmiany formatu identyfikatora.

string

Tylko dane wyjściowe. Identyfikator URI formularza do udostępnienia użytkownikom. Spowoduje to otwarcie strony, na której użytkownik może przesłać odpowiedzi, ale nie może edytować pytań.

string

Tylko dane wyjściowe. Identyfikator powiązanego arkusza Google, w którym gromadzone są odpowiedzi z tego formularza (jeśli taki arkusz istnieje).

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

string

Wymagane. Tytuł formularza widoczny dla odpowiadających.

string

Tylko dane wyjściowe. Tytuł dokumentu widocznego na Dysku. Jeśli pole Info.title jest puste, w interfejsie Formularzy Google może pojawić się pole documentTitle, które będzie widoczne dla osób wypełniających formularz. Wartość documentTitle można ustawić podczas tworzenia, ale nie można jej zmienić za pomocą żądania batchUpdate. Jeśli chcesz zaktualizować documentTitle za pomocą kodu, 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

Czy formularz jest testem. Jeśli jest ustawiona na wartość Prawda, odpowiedzi są oceniane na podstawie pytania Grading. Gdy ustawisz wartość na Fałsz, wszystkie pytania Grading zostaną usunięte.

{
  "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.

Można go podać podczas tworzenia, ale nie może być już używany w formularzu. Jeśli nie zostanie podany, zostanie przypisany nowy identyfikator.

string

Nazwa produktu.

string

Opis elementu.

object (QuestionItem)

Użytkownik zostaje poproszony o odpowiedź na pytanie.

object (QuestionGroupItem)

Zadaje użytkownikowi co najmniej 1 pytanie za pomocą jednego prompta głównego.

object (PageBreakItem)

rozpoczyna nową stronę z 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świetlone 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)
  },
  "ratingQuestion": {
    object (RatingQuestion)
  }
  // End of list of possible types for union field kind.
}

string

Tylko do odczytu. Identyfikator pytania.

Można go podać podczas tworzenia, ale nie może być już używany w formularzu. Jeśli nie zostanie podany, zostanie przypisany nowy identyfikator.

boolean

Czy pytanie musi zostać wypełnione, aby respondent mógł przesłać odpowiedź.

object (Grading)

Konfiguracja oceniania pytania.

object (ChoiceQuestion)

Użytkownik może wybrać jedną z wstępnie zdefiniowanych opcji.

object (TextQuestion)

Użytkownik może wpisać odpowiedź w formie dowolnego tekstu.

object (ScaleQuestion)

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

object (DateQuestion)

Respondent can enter a date.

object (TimeQuestion)

Użytkownik może podać godzinę.

object (FileUploadQuestion)

Respondent może przesłać co najmniej 1 plik.

object (RowQuestion)

Wiersz w tabeli QuestionGroupItem.

object (RatingQuestion)

Respondent może wybrać ocenę z wstępnie zdefiniowanego zestawu ikon.

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

enum (ChoiceType)

Wymagane. Typ pytania z wyborem.

object (Option)

Wymagane. Lista opcji, spośród których respondent musi wybrać jedną.

boolean

Określa, czy opcje mają być wyświetlane w losowej kolejności w różnych przypadkach testu. Jest to często wykorzystywane, aby zapobiec oszustwom ze strony respondentów, którzy mogliby podglądać ekran innego uczestnika ankiety, lub aby wyeliminować stronniczość w ankiecie, która może wystąpić, gdy te same opcje są zawsze podawane jako pierwsze lub ostatnie.

{
  "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świetlanie obrazu jako opcji.

boolean

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

enum (GoToAction)

Typ nawigacji w sekcji.

string

Identyfikator elementu w nagłówku sekcji, do którego chcesz 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. Jest on ważny tylko przez ograniczony czas.

string

Opis obrazu, który jest 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 użyty do wstawienia obrazu. Identyfikator URI źródła może być pusty podczas pobierania.

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

enum (Alignment)

Pozycja mediów.

integer

Szerokość multimediów w pikselach. Gdy multimedium jest wyświetlane, jest ono skalowane do mniejszej wartości lub szerokości wyświetlanego formularza. Oryginalny współczynnik proporcji multimediów jest zachowany. Jeśli podczas dodawania multimediów do formularza nie podasz szerokości, 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śloną jest dozwolone tylko podczas aktualizowania źródła multimediów.

{
  "paragraph": boolean
}

boolean

Czy pytanie jest pytaniem w akapitie. W przeciwnym razie pytanie będzie krótkim tekstem.

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

integer

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

integer

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

string

Etykieta wyświetlana w opisie najniższego punktu na skali.

string

Etykieta wyświetlana jako najwyższy punkt na skali.

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

boolean

Czy uwzględnić godzinę w pytaniu.

boolean

Określa, czy w pytaniu ma być uwzględniony rok.

{
  "duration": boolean
}

boolean

true, jeśli pytanie dotyczy upływu czasu. W przeciwnym razie chodzi o porę dnia.

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

string

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

enum (FileType)

Typy plików akceptowane przez to pytanie.

integer

Maksymalna liczba plików, które można przesłać w ramach jednej odpowiedzi na to pytanie.

string (int64 format)

Maksymalna liczba bajtów dozwolona dla pojedynczego pliku przesłanego do tego pytania.

{
  "title": string
}

string

Wymagane. Tytuł pojedynczego wiersza w tabeli QuestionGroupItem.

{
  "ratingScaleLevel": integer,
  "iconType": enum (RatingIconType)
}

integer

Wymagane. Poziom skali ocen pytania o ocenę.

enum (RatingIconType)

Wymagane. Typ ikony używany do oceny.

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

integer

Wymagane. Maksymalna liczba punktów, jaką respondent może automatycznie uzyskać za prawidłową odpowiedź. Nie może być ujemna.

object (CorrectAnswers)

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

object (Feedback)

Informacje wyświetlane w przypadku prawidłowych odpowiedzi. Ta opinia może być ustawiona tylko w przypadku pytań wielokrotnego wyboru, które mają podane prawidłowe odpowiedzi.

object (Feedback)

Opinia wyświetlana w przypadku nieprawidłowych odpowiedzi. Ta opinia może być ustawiona tylko w przypadku pytań wielokrotnego wyboru, które mają podane prawidłowe odpowiedzi.

object (Feedback)

Opinia wyświetlana przy wszystkich odpowiedziach. Jest to często używane w przypadku pytań z krótką odpowiedzią, gdy właściciel quizu chce szybko poinformować respondentów, czy ich odpowiedź na pytanie jest poprawna, zanim będzie można oficjalnie ocenić odpowiedź. W przypadku pytań jednokrotnego wyboru ocenianych automatycznie nie można ustawić ogólnej informacji zwrotnej.

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

object (CorrectAnswer)

lista poprawnych odpowiedzi; Odpowiedzi na quiz mogą być oceniane automatycznie na podstawie tych odpowiedzi. W przypadku pytań z jedną wartością odpowiedź jest uznawana za prawidłową, jeśli pasuje do dowolnej wartości na liście (czyli możliwe są liczne prawidłowe odpowiedzi). W przypadku pytań z wieloma wartościami (CHECKBOX) odpowiedź jest uznawana za prawidłową, jeśli zawiera dokładnie te wartości z listy.

{
  "value": string
}

string

Wymagane. Wartość prawidłowej odpowiedzi. Szczegółowe informacje o formatowaniu różnych typów wartości znajdziesz w dokumentacji 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 wpływać na to, jakie pytania 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. Gdy ustawisz wartość grid, wszystkie pytania w grupie muszą być typu row.

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

object (ChoiceQuestion)

Wymagane. opcje wspólne dla wszystkich pytań w siatce; Innymi słowy, wartości kolumn. Dozwolone są tylko opcje CHECK_BOX i RADIO.

boolean

Jeśli true, pytania są uporządkowane losowo. Inaczej mówiąc, wiersze są wyświetlane w różnej kolejności dla każdego respondenta.

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

object (Image)

Wymagane. Obraz wyświetlany w elemencie.

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

object (Video)

Wymagane. Film wyświetlany w produkcie.

string

Tekst wyświetlany pod filmem.

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

string

Wymagane. Identyfikator URI YouTube.

object (MediaProperties)

Właściwości filmu.