لمنح صنّاع النماذج مزيدًا من التحكّم في تحديد المستخدمين الذين يمكنهم الردّ، نقدّم عناصر تحكّم دقيقة للمجيبين. ستظهر النماذج التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات بعد 31 كانون الثاني (يناير) 2026 في حالة "غير منشور" تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على
تغييرات واجهة برمجة التطبيقات في "نماذج Google".
إعداد خيارات وضع علامات الاختبار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنّ إدارة الاختبارات هي إحدى الميزات الرئيسية في "نماذج Google". يوضّح لك هذا الدليل
كيفية إنشاء اختبار وإضافة خيارات وضع الدرجات باستخدام Forms API.
إنشاء اختبار أساسي
تتكوّن المرحلة الأولى من إنشاء اختبار من خطوتَين: إنشاء نموذج، ثم تعديل إعدادات النموذج لتحديده كاختبار. اطّلِع على مقالة إنشاء نموذج أو اختبار للحصول على تعليمات الإعداد الأساسية.
إضافة أسئلة
بعد إنشاء الاختبار، أضِف الأسئلة (اطّلِع على
Question object
للحصول على
قائمة بأنواع الأسئلة). يمكنك تضمين
خيارات وضع الدرجات عند إضافة الأسئلة لأول مرة، أو
تعديلها لاحقًا. نموذج رمز JSON لعنصر سؤال جديد يتضمّن
خيارات التقييم يظهر على النحو التالي:
"item": {
"title": "Which of these singers was not a member of Destiny's Child?",
"questionItem": {
"question": {
"required": True,
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [{"value": "Rihanna"}]
},
"whenRight": {"text": "You got it!"},
"whenWrong": {"text": "Sorry, that's wrong"}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{"value": "Kelly Rowland"},
{"value": "Beyoncé"},
{"value": "Rihanna"},
{"value": "Michelle Williams"}
]
}
}
}
}
اطّلِع على مقالة تعديل نموذج أو اختبار
لمعرفة كيفية إضافة عنصر سؤال إلى نموذج.
إضافة خيارات وضع الدرجات
تساعد إضافة خيارات وضع الدرجات إلى أسئلة الاختبار في أتمتة عملية وضع الدرجات.
يمكن أن يكون لكل سؤال قيمة نقاط محدّدة ويقدّم للمستخدِم ملاحظات حول
إجابته.
بالنسبة إلى أنواع الأسئلة أدناه، تتيح إضافة حقلcorrectAnswers
وضع الدرجات عليها تلقائيًا عند إرسال الاختبار. يمكنك تقديم ملاحظات محدّدة للإجابات الصحيحة وغير الصحيحة باستخدام الحقلَين whenRight
و
whenWrong
.
- مربّع اختيار
- راديو
- قائمة منسدلة
يمكن أيضًا وضع الدرجات على أسئلة الإجابة القصيرة تلقائيًا من خلال إضافة حقل correctAnswers
، ولكن يمكنك تقديم ملاحظات generalFeedback
فقط، وليس ملاحظات whenRight
أو
whenWrong
. بالنسبة إلى الأنواع الأخرى من الأسئلة، لا يتم وضع الدرجات تلقائيًا
ويمكنك تقديم generalFeedback
فقط.
ملاحظة: باستثناء الأسئلة التي يتم فيها تقديم الإجابة من خلال تحميل ملف، يتم تسجيل إجابة المستخدِم وتقييمها كنص (اطّلِع على عنصر
TextAnswer
لمعرفة تفاصيل عن كيفية تنسيق الأنواع المختلفة من الإجابات). لتكون الإجابة
صحيحة، يجب أن تتطابق تمامًا مع مفتاح الإجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)"],[],["Create a quiz in Google Forms by first building a form, then converting it to a quiz via settings. Add questions, specifying the question type and whether it's required. Include grading options like `pointValue`, `correctAnswers`, and feedback (`whenRight`, `whenWrong`). Questions with `correctAnswers` (Checkbox, Radio, Dropdown, Short answer) can be auto-graded. Feedback options are available for correct and incorrect answers, except for short answers that only offer `generalFeedback`. Answers are evaluated as text for correctness.\n"],null,["# Set up quiz grading options\n\nAdministering quizzes is one of the key features of Google Forms. This guide\nshows you how to create a quiz and add grading options with the Forms API.\n\nMake a basic quiz\n-----------------\n\nThe first stage of making a quiz is a two-step process: you create a form,\nthen update the form's settings to define it as a quiz. See\n[Create a form or quiz](/workspace/forms/api/guides/create-form-quiz#convert_a_form_to_a_quiz)\nfor basic setup instructions.\n\nAdd questions\n-------------\n\nAfter you've created the quiz, add the questions (see the\n[`Question object`](/workspace/forms/api/reference/rest/v1/forms#question) for a\nlist of question types). You can include\n[grading options](#grading-options) when you first add the questions, or\nupdate them later. Sample JSON code for a new question item that includes\ngrading options looks like this: \n\n \"item\": {\n \"title\": \"Which of these singers was not a member of Destiny's Child?\",\n \"questionItem\": {\n \"question\": {\n \"required\": True,\n \"grading\": {\n \"pointValue\": 2,\n \"correctAnswers\": {\n \"answers\": [{\"value\": \"Rihanna\"}]\n },\n \"whenRight\": {\"text\": \"You got it!\"},\n \"whenWrong\": {\"text\": \"Sorry, that's wrong\"}\n },\n \"choiceQuestion\": {\n \"type\": \"RADIO\",\n \"options\": [\n {\"value\": \"Kelly Rowland\"},\n {\"value\": \"Beyoncé\"},\n {\"value\": \"Rihanna\"},\n {\"value\": \"Michelle Williams\"}\n ]\n }\n }\n }\n }\n\nSee [Update a form or quiz](/workspace/forms/api/guides/update-form-quiz#add_an_item)\nto learn how to add a question item to a form.\n\nAdd grading options\n-------------------\n\nAdding grading options to quiz questions helps automate the grading process.\nEach question can have an assigned point value and give the user feedback about\ntheir answer.\n\nFor the question types below, adding a`correctAnswers` field enables them to\nbe automatically graded when the quiz is submitted. You can provide\nspecific feedback for correct and incorrect answers using the `whenRight` and\n`whenWrong` fields.\n\n- Checkbox\n- Radio\n- Dropdown\n\nShort answer questions can also be auto-graded by adding a `correctAnswers`\nfield, but you can only provide `generalFeedback`, not `whenRight` or\n`whenWrong` feedback. For other types of questions, grading is not automatic\nand you can only provide `generalFeedback`.\n\n**Note:** Except for questions where the answer is via a file upload, the\nuser's answer is captured and evaluated as text (see the\n[`TextAnswer`](/workspace/forms/api/reference/rest/v1/forms.responses#textanswer)\nobject for specifics about how different types of answers are formatted). To\nbe correct, the answer must match the answer key exactly."]]