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

سرد ردود نموذج