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))

النتائج فقط. الإجابات الفعلية عن الأسئلة، مفعَّلة حسب مفتاح 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

جميع الملفات التي تم إرسالها لسؤال 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

 إدراج الردود على نموذج