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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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))

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

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

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

Methods

get

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

list

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