- المورد: نموذج
- معلومات
- FormSettings
- QuizSettings
- السلعة
- QuestionItem
- السؤال
- ChoiceQuestion
- ChoiceType
- الخيار
- GoToAction
- الصورة
- MediaProperties
- المحاذاة
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- وضع الدرجات
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- شبكة
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- الفيديو
- الطُرق
المرجع: نموذج
مستند في "نماذج Google" يتم إنشاء نموذج في Drive، ويتم حذف نموذج أو تغيير إجراءات الحماية من أذونات الوصول الخاصة به من خلال Drive API.
تمثيل JSON |
---|
{ "formId": string, "info": { object ( |
الحقول | |
---|---|
formId |
النتائج فقط. رقم تعريف النموذج |
info |
مطلوبة. تمثّل هذه السمة عنوان النموذج ووصفه. |
settings |
إعدادات النموذج يجب تعديل هذا الحقل باستخدام السمة |
items[] |
مطلوبة. قائمة بعناصر النموذج والتي يمكن أن تتضمن عناوين الأقسام والأسئلة والوسائط المضمّنة وما إلى ذلك. |
revisionId |
النتائج فقط. رقم تعريف النسخة السابقة للنموذج. يُستخدم في قد يتغير تنسيق معرف النسخة السابقة بمرور الوقت، لذا يجب التعامل معه بشكل مبهم. يمكن ضمان صلاحية رقم تعريف النسخة السابقة الذي تم إرجاعه لمدة 24 ساعة فقط بعد إرجاعه، ولا يمكن مشاركته بين المستخدمين. إذا لم يتغير رقم تعريف النسخة السابقة بين عمليات الاستدعاء، فهذا يعني أن النموذج لم يتغير. وفي المقابل، عادةً ما يعني تغيير رقم التعريف (للنموذج نفسه والمستخدم) أنّه قد تم تعديل النموذج، ولكن قد يرجع تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل التغييرات في تنسيق رقم التعريف. |
responderUri |
النتائج فقط. معرّف الموارد المنتظم (URI) للنموذج المطلوب مشاركته مع المجيبين يؤدي ذلك إلى فتح صفحة تسمح للمستخدم بإرسال الردود وليس تعديل الأسئلة. |
linkedSheetId |
النتائج فقط. رقم تعريف "جدول بيانات Google" المرتبط الذي يجمع الردود من هذا النموذج (في حال توفُّر جدول بيانات كهذا). |
معلومات
تمثّل هذه السمة المعلومات العامة لنموذج.
تمثيل JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
الحقول | |
---|---|
title |
مطلوبة. تمثّل هذه السمة عنوان النموذج الذي يظهر للمجيبين. |
documentTitle |
النتائج فقط. عنوان المستند الذي يظهر في Drive. إذا كان |
description |
تمثّل هذه السمة وصف النموذج. |
FormSettings
إعدادات نموذج.
تمثيل JSON |
---|
{
"quizSettings": {
object ( |
الحقول | |
---|---|
quizSettings |
الإعدادات المرتبطة بنماذج الاختبارات ووضع الدرجات |
QuizSettings
الإعدادات المرتبطة بنماذج الاختبارات ووضع الدرجات ويجب تعديلها باستخدام UpdateSettingsRequest.
تمثيل JSON |
---|
{ "isQuiz": boolean } |
الحقول | |
---|---|
isQuiz |
ما إذا كان هذا النموذج اختبارًا أم لا. عندما تكون القيمة "true"، يتم تقييم الردود استنادًا إلى السؤال |
المنتج/الخدمة
تمثّل هذه السمة عنصرًا واحدًا من النموذج. وتحدّد الخاصية kind
نوع العنصر.
تمثيل JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
الحقول | |
---|---|
itemId |
معرّف السلعة. عند الإنشاء، يمكن تقديم المعرّف ولكن يجب ألا يكون المعرّف مستخدم في النموذج. وفي حال عدم توفيرها، يتم تعيين مُعرّف جديد. |
title |
عنوان السلعة. |
description |
وصف السلعة. |
حقل الاتحاد kind مطلوبة. نوع هذا العنصر. يمكن أن يكون kind واحدًا فقط مما يلي: |
|
questionItem |
طرح سؤال للمستخدم. |
questionGroupItem |
تطرح سؤالاً واحدًا أو أكثر على المستخدم بمطالبة رئيسية واحدة. |
pageBreakItem |
بدء صفحة جديدة بعنوان. |
textItem |
تعرض عنوانًا ووصفًا على الصفحة. |
imageItem |
عرض صورة على الصفحة |
videoItem |
تعرض فيديو على الصفحة. |
QuestionItem
عنصر نموذج يحتوي على سؤال واحد.
تمثيل JSON |
---|
{ "question": { object ( |
الحقول | |
---|---|
question |
مطلوبة. السؤال المعروض. |
image |
الصورة المعروضة داخل السؤال. |
السؤال
أي سؤال. يُعرف النوع المحدد من الأسئلة من خلال kind
.
تمثيل JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
الحقول | |
---|---|
questionId |
للقراءة فقط. معرِّف السؤال. عند الإنشاء، يمكن تقديم المعرّف ولكن يجب ألا يكون المعرّف مستخدم في النموذج. وفي حال عدم توفيرها، يتم تعيين مُعرّف جديد. |
required |
ما إذا كان يجب الإجابة عن السؤال حتى يتمكن المجيب من إرسال رده. |
grading |
إعداد وضع الدرجات للسؤال |
حقل الاتحاد kind مطلوبة. تمثّل هذه السمة نوع السؤال الذي تم طرحه على المجيب. يمكن أن تكون السمة "kind " واحدة فقط مما يلي: |
|
choiceQuestion |
يمكن للمجيب الاختيار من بين مجموعة محددة مسبقًا من الخيارات. |
textQuestion |
يمكن للمجيب إدخال رد نصي حر. |
scaleQuestion |
يمكن للمجيب اختيار رقم من نطاق. |
dateQuestion |
يمكن للمجيب إدخال تاريخ. |
timeQuestion |
يمكن للمجيب إدخال وقت. |
fileUploadQuestion |
يمكن للمجيب تحميل ملف واحد أو أكثر. |
rowQuestion |
صف من |
ChoiceQuestion
سؤال راديو/مربّع اختيار/قائمة منسدلة
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوبة. تمثّل هذه السمة نوع السؤال الاختياري. |
options[] |
مطلوبة. قائمة بالخيارات التي يجب على المجيب الاختيار من بينها. |
shuffle |
ما إذا كان يجب عرض الخيارات بترتيب عشوائي لمثيلات مختلفة من الاختبار. غالبًا ما يستخدم هذا لمنع الغش من قبل المشاركين الذين قد ينظرون إلى شاشة مستجيب آخر، أو لمعالجة التحيز في استبيان قد يتم تقديمه من خلال وضع نفس الخيارات دائمًا في المقام الأول أو الأخير. |
ChoiceType
تمثّل هذه السمة نوع الاختيار.
عمليات التعداد | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
القيمة التلقائية. غير مستخدَمة |
RADIO |
أزرار الاختيار: يتم عرض جميع الاختيارات للمستخدم الذي يمكنه اختيار زر واحد فقط. |
CHECKBOX |
مربّعات الاختيار: يتم عرض جميع الاختيارات للمستخدم الذي يمكنه اختيار أي عدد منها. |
DROP_DOWN |
القائمة المنسدلة: تظهر الخيارات للمستخدم عند الطلب فقط، وإلا سيتم عرض الخيار الحالي فقط. يمكن تحديد خيار واحد فقط. |
Option
خيار لسؤال الاختيار.
تمثيل JSON |
---|
{ "value": string, "image": { object ( |
الحقول | |
---|---|
value |
مطلوبة. الاختيار على النحو الذي يتم تقديمه للمستخدم. |
image |
عرض الصورة كخيار. |
isOther |
ما إذا كان الخيار هو "غير ذلك". ينطبق هذا الخيار حاليًا على نوعَي الاختيار |
حقل الاتحاد go_to_section القسم الذي تريد الانتقال إليه إذا تم تحديد هذا الخيار. ينطبق حاليًا على نوع الاختيار RADIO وSELECT فقط، ولكنه غير مسموح به في QuestionGroupItem . يمكن أن تكون السمة "go_to_section " واحدة فقط مما يلي: |
|
goToAction |
نوع التنقّل في الأقسام |
goToSectionId |
رقم تعريف العنصر لعنوان القسم المطلوب الانتقال إليه. |
GoToAction
الثوابت للتنقل بين الأقسام.
عمليات التعداد | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
القيمة التلقائية. غير مستخدَمة |
NEXT_SECTION |
الانتقال إلى القسم التالي |
RESTART_FORM |
العودة إلى بداية النموذج. |
SUBMIT_FORM |
يُرجى إرسال النموذج على الفور. |
صورة
يشير ذلك المصطلح إلى البيانات التي تمثّل صورة.
تمثيل JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
الحقول | |
---|---|
contentUri |
النتائج فقط. معرف موارد منتظم (URI) يمكنك من خلاله تنزيل الصورة، وهو صالح فقط لفترة محدودة. |
altText |
وصف للصورة يتم عرضه عند التمرير وقراءته بواسطة برامج قراءة الشاشة. |
properties |
خصائص الصورة. |
حقل الاتحاد image_source نوع مصدر الصورة يجب ضبط حقل واحد فقط لمصدر الصورة عند إنشاء صور جديدة. يمكن أن تكون السمة "image_source " واحدة فقط مما يلي: |
|
sourceUri |
الإدخال فقط. عنوان URI المصدر هو عنوان URI المستخدم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (URI) للمصدر فارغًا عند جلبه. |
MediaProperties
خصائص الوسائط.
تمثيل JSON |
---|
{
"alignment": enum ( |
الحقول | |
---|---|
alignment |
موقف وسائل الإعلام. |
width |
عرض الوسائط بالبكسل. عند عرض الوسائط، يتم تغيير حجمها إلى أصغر هذه القيمة أو عرض النموذج المعروض. ويتم الحفاظ على نسبة العرض إلى الارتفاع الأصلية للوسائط. إذا لم يتم تحديد عرض عند إضافة الوسائط إلى النموذج، يتم ضبطها على عرض مصدر الوسائط. يجب أن يتراوح العرض بين 0 و740 (شاملةً). لا يُسمح بضبط العرض على 0 أو على غير محدّد إلا عند تعديل مصدر الوسائط. |
محاذاة
محاذاة على الصفحة.
عمليات التعداد | |
---|---|
ALIGNMENT_UNSPECIFIED |
القيمة التلقائية. غير مستخدَمة |
LEFT |
محاذاة لليسار. |
RIGHT |
محاذاة إلى اليمين. |
CENTER |
الوسط. |
TextQuestion
سؤال نصي.
تمثيل JSON |
---|
{ "paragraph": boolean } |
الحقول | |
---|---|
paragraph |
ما إذا كان السؤال عبارة عن سؤال فقرة أم لا. إذا لم يكن كذلك، يكون السؤال سؤالاً نصيًا قصيرًا. |
ScaleQuestion
سؤال مقياس. لدى المستخدم مجموعة من القيم الرقمية للاختيار من بينها.
تمثيل JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
الحقول | |
---|---|
low |
مطلوبة. تمثّل هذه السمة أدنى قيمة ممكنة للمقياس. |
high |
مطلوبة. تمثّل هذه السمة أعلى قيمة ممكنة للمقياس. |
lowLabel |
التسمية المطلوب عرضها لوصف أدنى نقطة على المقياس. |
highLabel |
التسمية المطلوب عرضها لوصف أعلى نقطة على المقياس. |
DateQuestion
سؤال تاريخ الإعداد التلقائي لأسئلة التاريخ هو شهر ويوم فقط.
تمثيل JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
الحقول | |
---|---|
includeTime |
ما إذا كان سيتم تضمين الوقت كجزء من السؤال. |
includeYear |
ما إذا كان سيتم تضمين السنة كجزء من السؤال. |
TimeQuestion
سؤال زمني
تمثيل JSON |
---|
{ "duration": boolean } |
الحقول | |
---|---|
duration |
|
FileUploadQuestion
سؤال حول تحميل ملف لا تتيح واجهة برمجة التطبيقات حاليًا إنشاء أسئلة لتحميل الملفات.
تمثيل JSON |
---|
{
"folderId": string,
"types": [
enum ( |
الحقول | |
---|---|
folderId |
مطلوبة. رقم تعريف مجلد Drive حيث يتم تخزين الملفات المحمَّلة. |
types[] |
أنواع الملفات المقبولة لهذا السؤال. |
maxFiles |
الحد الأقصى لعدد الملفات التي يمكن تحميلها لهذا السؤال في إجابة واحدة |
maxFileSize |
الحد الأقصى لعدد وحدات البايت المسموح بها لأي ملف فردي تم تحميله إلى هذا السؤال. |
FileType
أنواع الملفات التي يمكن تحميلها إلى سؤال حول تحميل الملفات
عمليات التعداد | |
---|---|
FILE_TYPE_UNSPECIFIED |
القيمة التلقائية. غير مستخدَمة |
ANY |
لا توجد قيود على النوع. |
DOCUMENT |
مستند في "مستندات Google" |
PRESENTATION |
عرض تقديمي في "العروض التقديمية من Google" |
SPREADSHEET |
جدول بيانات من "جداول بيانات Google" |
DRAWING |
رسم. |
PDF |
ملف PDF |
IMAGE |
صورة. |
VIDEO |
فيديو. |
AUDIO |
ملف صوتي |
RowQuestion
الإعدادات لسؤال يكون جزءًا من مجموعة أسئلة.
تمثيل JSON |
---|
{ "title": string } |
الحقول | |
---|---|
title |
مطلوبة. تمثّل هذه السمة عنوان الصف الفردي في |
وضع العلامات
وضع الدرجات لسؤال واحد
تمثيل JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
الحقول | |
---|---|
pointValue |
مطلوبة. تمثّل هذه السمة الحد الأقصى لعدد النقاط التي يمكن للمجيب الحصول عليها تلقائيًا للإجابة الصحيحة. يجب ألا يكون هذا العدد سالبًا. |
correctAnswers |
مطلوبة. تمثّل هذه السمة مفتاح الإجابة للسؤال. يتم وضع درجات على الردود تلقائيًا استنادًا إلى هذا الحقل. |
whenRight |
الملاحظات المعروضة للإجابات الصحيحة. لا يمكن ضبط هذه الملاحظات إلا لأسئلة الاختيار من متعدد التي تم تقديم إجابات صحيحة لها. |
whenWrong |
تمثّل هذه السمة الملاحظات التي يتم عرضها للردود غير الصحيحة. لا يمكن ضبط هذه الملاحظات إلا لأسئلة الاختيار من متعدد التي تم تقديم إجابات صحيحة لها. |
generalFeedback |
تمثّل هذه السمة الملاحظات المعروضة لجميع الإجابات. يتم استخدام هذا بشكل شائع للأسئلة ذات الإجابات القصيرة عندما يريد مالك الاختبار إعطاء المستجيبين سريعًا فكرة ما إذا كانوا أجابوا عن السؤال بشكل صحيح قبل أن تتاح لهم الفرصة لتقييم الإجابة رسميًا. لا يمكن ضبط الملاحظات العامة لأسئلة الاختيار من متعدد التي يتم تقييمها تلقائيًا. |
CorrectAnswers
مفتاح الإجابة لسؤال.
تمثيل JSON |
---|
{
"answers": [
{
object ( |
الحقول | |
---|---|
answers[] |
قائمة بالإجابات الصحيحة. يمكن وضع درجات على إجابة الاختبار تلقائيًا بناءً على هذه الإجابات. بالنسبة إلى الأسئلة ذات القيمة الفردية، يتم وضع علامة على الإجابة "صحيحة" إذا كانت تتطابق مع أي قيمة في هذه القائمة (بمعنى آخر، يمكن تقديم إجابات صحيحة متعدّدة). بالنسبة إلى الأسئلة متعددة القيم ( |
CorrectAnswer
إجابة واحدة صحيحة عن سؤال. بالنسبة إلى الأسئلة متعددة القيم (CHECKBOX
)، قد تحتاج إلى عدة قيم CorrectAnswer
لتمثيل خيار إجابة واحد صحيح.
تمثيل JSON |
---|
{ "value": string } |
الحقول | |
---|---|
value |
مطلوبة. تمثّل هذه السمة قيمة الإجابة الصحيحة. يمكنك الاطّلاع على مستندات |
QuestionGroupItem
تحدد سؤالاً يتكون من أسئلة متعددة مجمعة معًا.
تمثيل JSON |
---|
{ "questions": [ { object ( |
الحقول | |
---|---|
questions[] |
مطلوبة. قائمة بالأسئلة التي تنتمي إلى مجموعة الأسئلة هذه. يجب أن ينتمي السؤال إلى مجموعة واحدة فقط. قد تؤثر |
image |
الصورة التي تظهر داخل مجموعة الأسئلة أعلى الأسئلة المحددة. |
حقل الاتحاد kind مطلوبة. نوع مجموعة الأسئلة الذي يحدد أنواع الأسئلة المسموح بها وكيفية عرضها. يمكن أن تكون السمة "kind " واحدة فقط مما يلي: |
|
grid |
مجموعة الأسئلة هي شبكة بها صفوف من أسئلة الاختيار من متعدد التي تشترك في نفس الخيارات. عند ضبط |
معرّف الإصدار العالمي (GRid)
شبكة من الخيارات (مربع اختيار أو تحديد) يشكل كل صف سؤالاً منفصلاً. يحتوي كل صف على نفس الخيارات، والتي تظهر كأعمدة.
تمثيل JSON |
---|
{
"columns": {
object ( |
الحقول | |
---|---|
columns |
مطلوبة. الخيارات التي يشاركها كل سؤال في الشبكة. بمعنى آخر، قيم الأعمدة. يُسمح فقط بـ |
shuffleQuestions |
إذا كانت الإجابة |
PageBreakItem
فاصل صفحة يتم عرض عنوان هذا العنصر ووصفه في أعلى الصفحة الجديدة.
TextItem
عنصر نصي.
ImageItem
عنصر يحتوي على صورة
تمثيل JSON |
---|
{
"image": {
object ( |
الحقول | |
---|---|
image |
مطلوبة. الصورة المعروضة في السلعة. |
VideoItem
عنصر يحتوي على فيديو.
تمثيل JSON |
---|
{
"video": {
object ( |
الحقول | |
---|---|
video |
مطلوبة. الفيديو المعروض في العنصر. |
caption |
النص المعروض أسفل الفيديو. |
حملة فيديو
تمثّل هذه السمة البيانات التي تمثّل الفيديو.
تمثيل JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
الحقول | |
---|---|
youtubeUri |
مطلوبة. معرّف موارد منتظم (URI) لمنصة YouTube |
properties |
خصائص الفيديو |
الطُرق |
|
---|---|
|
يمكنك تغيير النموذج باستخدام مجموعة من التعديلات. |
|
يمكنك إنشاء نموذج جديد باستخدام العنوان الوارد في رسالة النموذج المقدّمة في الطلب. |
|
الحصول على نموذج |