REST Resource: forms.responses

Ресурс: FormResponse

Форма ответа.

JSON-представление 
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Поля
formId

string

Только вывод. Идентификатор формы.

responseId

string

Только вывод. Идентификатор ответа.

createTime

string ( Timestamp format)

Только вывод. Временная метка первой отправки ответа.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastSubmittedTime

string ( Timestamp format)

Только вывод. Временная метка последнего времени отправки ответа. Не отслеживает изменения оценок.

Использует RFC 3339, где генерируемые выходные данные всегда будут нормализованы по Z и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

respondentEmail

string

Только вывод. Адрес электронной почты (если имеется) респондента.

answers

map (key: string, value: object ( Answer ))

Только вывод. Фактические ответы на вопросы, сгруппированные по идентификатору вопроса.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

totalScore

number

Только вывод. Общее количество баллов, которое респондент получил за свою работу. Устанавливается только в том случае, если форма представляла собой тест и ответ оценивался. Сюда входят баллы, автоматически начисляемые посредством автооценки с учетом любых ручных исправлений, внесенных владельцем формы.

Отвечать

Представленный ответ на вопрос.

JSON-представление 
{
  "questionId": string,
  "grade": {
    object (Grade)
  },

  // Union field value can be only one of the following:
  "textAnswers": {
    object (TextAnswers)
  },
  "fileUploadAnswers": {
    object (FileUploadAnswers)
  }
  // End of list of possible types for union field value.
}
Поля
questionId

string

Только вывод. Идентификатор вопроса. См. также Question.question_id .

grade

object ( Grade )

Только вывод. Оценка за ответ, если форма представляла собой тест.

value поля объединения. Ответ пользователя. value может быть только одним из следующих:
textAnswers

object ( TextAnswers )

Только вывод. Конкретные ответы в виде текста.

fileUploadAnswers

object ( FileUploadAnswers )

Только вывод. Ответы на вопрос о загрузке файла.

ТекстОтветы

Ответы на вопросы в виде текста.

JSON-представление 
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Поля
answers[]

object ( TextAnswer )

Только вывод. Ответы на вопрос. Для ChoiceQuestion с несколькими значениями каждый ответ представляет собой отдельное значение.

ТекстОтвет

Ответ на вопрос, представленный в виде текста.

JSON-представление 
{
  "value": string
}
Поля
value

string

Только вывод. Значение ответа.

Форматирование, используемое для различных типов вопросов:

  • ChoiceQuestion
    • RADIO или DROP_DOWN : одна строка, соответствующая выбранной опции.
    • CHECKBOX : несколько строк, соответствующих каждому выбранному параметру.
  • TextQuestion : текст, введенный пользователем.
  • ScaleQuestion : строка, содержащая выбранное число.
  • DateQuestion
    • Без времени и года: ММ-ДД, например «05-19».
    • С годом: ГГГГ-ММ-ДД, например «19 мая 1986 г.»
    • Со временем: ММ-ДД ЧЧ:ММ, например «05-19 14:51».
    • Год и время: ГГГГ-ММ-ДД ЧЧ:ММ, например «1986-05-19 14:51».
  • TimeQuestion : строка со временем или продолжительностью в формате ЧЧ:ММ, например «14:51».
  • RowQuestion внутри QuestionGroupItem : ответ для каждой строки QuestionGroupItem представлен как отдельный Answer . Каждый из них будет содержать одну строку для выбора типа RADIO или несколько строк для выбора типа CHECKBOX .

FileUploadAnswers

Все отправленные файлы на вопрос FileUpload.

JSON-представление 
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Поля
answers[]

object ( FileUploadAnswer )

Только вывод. Все отправленные файлы на вопрос FileUpload.

FileUploadAnswer

Информация об одном файле, отправленном на вопрос о загрузке файла.

JSON-представление 
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Поля
fileId

string

Только вывод. Идентификатор файла Google Диска.

fileName

string

Только вывод. Имя файла, сохраненное на Google Диске при загрузке.

mimeType

string

Только вывод. MIME-тип файла, сохраненный на Google Диске при загрузке.

Оценка

Информация об оценке, связанная с ответом респондента на вопрос.

JSON-представление 
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Поля
score

number

Только вывод. Числовой балл, присуждаемый за ответ.

correct

boolean

Только вывод. Правильно ли был дан ответ на вопрос или нет. Нулевого балла недостаточно, чтобы сделать вывод о неправильности, поскольку правильный ответ на вопрос может стоить ноль баллов.

feedback

object ( Feedback )

Только вывод. За ответ дан дополнительный отзыв.

Методы

get

 Получите один ответ из формы.

list

 Перечислите ответы формы.