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

النتائج فقط. الإجابات الفعلية عن الأسئلة، مصحوبةً بمؤشر السؤال معرف السؤال.

عنصر يحتوي على قائمة بأزواج "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

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