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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastSubmittedTime

string (Timestamp format)

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

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

string

פלט בלבד. כתובת האימייל (אם היא נאספו) של המשיב.
answers

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

פלט בלבד. התשובות בפועל לשאלות, המפתחות על ידי queryId.

אובייקט שמכיל רשימה של "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

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

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

object (FileUploadAnswer)

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

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

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