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)

פלט בלבד. חותמת הזמן של הפעם הראשונה שבה התשובה נשלחה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של הפעם האחרונה שבה התשובה נשלחה. לא עוקבים אחרי שינויים בציונים.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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)

פלט בלבד. תשובות לשאלה בנושא העלאת קבצים.

TextAnswers

תשובות של שאלה כטקסט.

ייצוג JSON
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
שדות
answers[]

object (TextAnswer)

פלט בלבד. מענה על שאלה. אם מזינים כמה ערכים של ChoiceQuestion, כל תשובה היא ערך נפרד.

TextAnswer

תשובה לשאלה שמיוצגת כטקסט.

ייצוג JSON
{
  "value": string
}
שדות
value

string

פלט בלבד. ערך התשובה.

הפורמטים השונים של השאלות:

  • ChoiceQuestion
    • RADIO או DROP_DOWN: מחרוזת יחידה שתואמת לאפשרות שנבחרה.
    • CHECKBOX: מספר מחרוזות שתואמות לכל אפשרות שנבחרה.
  • TextQuestion: הטקסט שהמשתמש הזין.
  • ScaleQuestion: מחרוזת שמכילה את המספר שנבחר.
  • DateQuestion
    • בלי זמן או שנה: MM-DD, למשל: '05-19'
    • עם שנה: YYYY-MM-DD, למשל: "1986-05-19"
    • עם זמן: MM-DD HH:MM, למשל: 05-19 14:51
    • עם שנה ושעה: YYYY-MM-DD HH:MM, למשל: 1986-05-19 14:51
  • TimeQuestion: מחרוזת עם שעה או משך זמן בפורמט HH:MM, למשל. 14:51
  • RowQuestion בתוך QuestionGroupItem: התשובה לכל שורה ב-QuestionGroupItem מיוצגת כ-Answer נפרד. כל אחת מהן תכלול מחרוזת אחת עבור אפשרויות מסוג RADIO או כמה מחרוזות עבור אפשרויות של CHECKBOX.

FileUploadAnswers

כל הקבצים שנשלחו לשאלה לגבי העלאת קבצים.

ייצוג JSON
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
שדות
answers[]

object (FileUploadAnswer)

פלט בלבד. כל הקבצים שנשלחו לשאלה לגבי העלאת קבצים.

FileUploadAnswer

מידע על קובץ יחיד שנשלח לשאלה עם העלאת קובץ.

ייצוג JSON
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
שדות
fileId

string

פלט בלבד. המזהה של הקובץ ב-Google Drive.

fileName

string

פלט בלבד. שם הקובץ, כפי שיישמר ב-Google Drive בזמן ההעלאה.

mimeType

string

פלט בלבד. סוג ה-MIME של הקובץ, כפי שנשמר ב-Google Drive בזמן ההעלאה.

ציון

מידע על מתן ציונים שמשויך לתשובה של המשיב לשאלה.

ייצוג JSON
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
שדות
score

number

פלט בלבד. הציון המספרי שניתן לתשובה.

correct

boolean

פלט בלבד. האם השאלה נענתה נכון או לא. ציון של אפס נקודות לא מספיק כדי להסיק טעות, מפני ששאלה שקיבלה תשובה נכונה יכולה להיות שווה אפס נקודות.

feedback

object (Feedback)

פלט בלבד. משוב נוסף שניתן על תשובה.

שיטות

get

מקבלים תשובה אחת מהטופס.

list

הצגת רשימה של תשובות לטופס.