- المرجع: النموذج
- معلومات
- FormSettings
- QuizSettings
- EmailCollectionType
- العنصر
- QuestionItem
- السؤال
- ChoiceQuestion
- ChoiceType
- الخيار
- GoToAction
- الصورة
- MediaProperties
- المحاذاة
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- RatingQuestion
- RatingIconType
- التصنيف
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- الشبكة
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- الفيديو
- الطُرق
المرجع: نموذج
مستند "نماذج Google" يتم إنشاء نموذج في Drive، ويتم حذف نموذج أو تغيير إجراءات حماية الوصول إليه من خلال Drive API.
تمثيل JSON |
---|
{ "formId": string, "info": { object ( |
الحقول | |
---|---|
form |
النتائج فقط. رقم تعريف النموذج |
info |
مطلوب. عنوان النموذج ووصفه |
settings |
إعدادات النموذج يجب تعديل هذا الإعداد باستخدام |
items[] |
مطلوب. قائمة بعناصر النموذج، والتي يمكن أن تتضمّن عناوين الأقسام والأسئلة والوسائط المضمّنة وما إلى ذلك |
revision |
النتائج فقط. معرّف النسخة السابقة من النموذج تُستخدَم في قد يتغيّر تنسيق معرّف المراجعة بمرور الوقت، لذا يجب التعامل معه بشكل غير شفاف. لا يمكن ضمان صلاحية معرّف المراجعة الذي تم إرجاعه إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته مع جميع المستخدمين. إذا لم يتغيّر معرّف المراجعة بين المكالمات، يعني ذلك أنّ النموذج لم يتغيّر. في المقابل، يعني المعرّف المتغيّر (للنموذج والمستخدم نفسهما) عادةً أنّه تم تعديل النموذج، ولكن يمكن أن يكون المعرّف المتغيّر أيضًا ناتجًا عن عوامل داخلية، مثل تغييرات في تنسيق المعرّف. |
responder |
النتائج فقط. معرّف الموارد المنتظم (URI) للنموذج لمشاركته مع المجيبين يؤدي ذلك إلى فتح صفحة تتيح للمستخدم إرسال الردود ولكن لا تتيح له تعديل الأسئلة. |
linked |
النتائج فقط. رقم تعريف "جدول بيانات Google" المرتبط الذي يجمع الردود من هذا النموذج (في حال توفّر جدول بيانات). |
معلومات
المعلومات العامة لنموذج معيّن
تمثيل JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
الحقول | |
---|---|
title |
مطلوب. عنوان النموذج الذي يظهر للمجيبين |
document |
النتائج فقط. عنوان المستند الذي يظهر في Drive إذا كانت |
description |
وصف النموذج |
FormSettings
إعدادات النموذج
تمثيل JSON |
---|
{ "quizSettings": { object ( |
الحقول | |
---|---|
quiz |
الإعدادات ذات الصلة بنماذج الاختبارات ووضع العلامات |
email |
اختيارية: الإعداد الذي يحدّد ما إذا كان النموذج سيجمع عناوين البريد الإلكتروني من المستجيبين |
QuizSettings
الإعدادات ذات الصلة بنماذج الاختبارات ووضع العلامات يجب تعديل هذه الإعدادات باستخدام UpdateSettingsRequest.
تمثيل JSON |
---|
{ "isQuiz": boolean } |
الحقول | |
---|---|
is |
ما إذا كان هذا النموذج اختبارًا أم لا عندما يكون هذا الحقل صحيحًا، يتم وضع علامات على الردود استنادًا إلى السؤال |
EmailCollectionType
اختيارية: الإعداد الذي يحدّد ما إذا كان النموذج يجمع عناوين البريد الإلكتروني من المستجيبين وكيفية جمع عناوين البريد الإلكتروني إذا كان النموذج يجمع عناوين البريد الإلكتروني، تتم تعبئة القيم في الحقل formResponse.respondentEmail
.
عمليات التعداد | |
---|---|
EMAIL_COLLECTION_TYPE_UNSPECIFIED |
غير محدد هذه القيمة غير مستخدَمة. |
DO_NOT_COLLECT |
لا يجمع النموذج عناوين البريد الإلكتروني. القيمة التلقائية إذا كان صاحب النموذج يستخدم حسابًا على Google. |
VERIFIED |
يجمع النموذج عناوين البريد الإلكتروني تلقائيًا استنادًا إلى حساب المستخدم الذي سجّل الدخول. القيمة التلقائية إذا كان مالك النموذج يستخدم حسابًا على Google Workspace. |
RESPONDER_INPUT |
يجمع النموذج عناوين البريد الإلكتروني باستخدام حقل يملؤه المجيب في النموذج. |
المنتج/الخدمة
عنصر واحد من النموذج تحدّد السمة kind
نوع العنصر.
تمثيل JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
الحقول | |
---|---|
item |
معرّف السلعة. عند الإنشاء، يمكن تقديمه ولكن يجب ألا يكون المعرّف قد سبق استخدامه في النموذج. في حال عدم تقديم معرّف، سيتمّ تعيينه تلقائيًا. |
title |
عنوان السلعة |
description |
وصف السلعة |
حقل الربط kind مطلوب. نوع العنصر. يمكن أن يكون kind واحدًا فقط مما يلي: |
|
question |
طرح سؤال على المستخدم |
question |
تطرح سؤالاً واحدًا أو أكثر على المستخدم من خلال طلب رئيسي واحد. |
page |
بدء صفحة جديدة تتضمّن عنوانًا |
text |
تعرِض هذه السمة عنوانًا ووصفًا على الصفحة. |
image |
تعرِض هذه السمة صورة على الصفحة. |
video |
تعرِض هذه السمة فيديو على الصفحة. |
QuestionItem
عنصر نموذج يحتوي على سؤال واحد
تمثيل JSON |
---|
{ "question": { object ( |
الحقول | |
---|---|
question |
مطلوب. السؤال المعروض. |
image |
الصورة المعروضة في السؤال |
السؤال
أي سؤال يُعرَف النوع المحدّد من السؤال من خلال kind
.
تمثيل JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
الحقول | |
---|---|
question |
للقراءة فقط. رقم تعريف السؤال. عند الإنشاء، يمكن تقديمه ولكن يجب ألا يكون المعرّف قد سبق استخدامه في النموذج. في حال عدم تقديم معرّف، سيتمّ تعيينه تلقائيًا. |
required |
ما إذا كان يجب الإجابة عن السؤال لكي يتمكّن المجيب من إرسال رده |
grading |
إعداد وضع العلامات على السؤال |
حقل الربط kind مطلوب. نوع السؤال الذي يُطرح على أحد المستجيبين يمكن أن يكون kind واحدًا مما يلي فقط: |
|
choice |
يمكن للمجيب الاختيار من بين مجموعة محدّدة مسبقًا من الخيارات. |
text |
يمكن للمجيب إدخال ردّ نصي حر. |
scale |
يمكن للمجيب اختيار رقم من نطاق معيّن. |
date |
يمكن للمجيب إدخال تاريخ. |
time |
يمكن للمجيب إدخال وقت. |
file |
يمكن للمجيب تحميل ملف واحد أو أكثر. |
row |
صف من |
rating |
يمكن للمجيب اختيار تقييم من مجموعة محدّدة مسبقًا من الرموز. |
ChoiceQuestion
سؤال يتضمّن زر اختيار/مربّع اختيار/قائمة منسدلة
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب. نوع سؤال الخيار |
options[] |
مطلوب. قائمة بالخيارات التي يجب أن يختار منها المجيب |
shuffle |
ما إذا كان يجب عرض الخيارات بترتيب عشوائي في النُسخ المختلفة من الاختبار ويُستخدَم ذلك غالبًا لمنع الغش من قِبل المجيبين الذين قد ينظرون إلى شاشة مستخدِم آخر، أو لمعالجة الانحياز في استطلاع الرأي الذي قد يتم تقديمه من خلال وضع الخيارات نفسها دائمًا أولاً أو آخرًا. |
ChoiceType
نوع الخيار
عمليات التعداد | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
القيمة التلقائية غير مستخدَمة |
RADIO |
أزرار الاختيار: يتم عرض كل الخيارات للمستخدم الذي يمكنه اختيار زر واحد فقط. |
CHECKBOX |
مربّعات الاختيار: يتم عرض جميع الخيارات للمستخدم الذي يمكنه اختيار أي عدد منها. |
DROP_DOWN |
القائمة المنسدلة: لا تظهر الخيارات للمستخدم إلا عند الطلب، وإلا يتم عرض الخيار الحالي فقط. يمكن اختيار خيار واحد فقط. |
Option
خيار لسؤال خيارات
تمثيل JSON |
---|
{ "value": string, "image": { object ( |
الحقول | |
---|---|
value |
مطلوب. الخيار كما يتم عرضه للمستخدم |
image |
عرض الصورة كخيار |
is |
ما إذا كان الخيار هو "غير ذلك" لا ينطبق هذا الإجراء حاليًا إلا على نوعَي الخيارَين |
حقل الربط go_to_section القسم الذي سيتم الانتقال إليه في حال تحديد هذا الخيار لا ينطبق هذا الخيار حاليًا إلا على نوعَي الخيار RADIO وSELECT ، ولكن لا يُسمح به في QuestionGroupItem . يمكن أن يكون go_to_section واحدًا مما يلي فقط: |
|
go |
نوع التنقّل في القسم |
go |
معرّف السلعة لعنوان القسم الذي تريد الانتقال إليه. |
GoToAction
ثوابت لتنقّل القسم
عمليات التعداد | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
القيمة التلقائية غير مستخدَمة |
NEXT_SECTION |
انتقِل إلى القسم التالي. |
RESTART_FORM |
ارجع إلى بداية النموذج. |
SUBMIT_FORM |
يُرجى إرسال النموذج على الفور. |
صورة
بيانات تمثّل صورة
تمثيل JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
الحقول | |
---|---|
content |
النتائج فقط. عنوان URL يمكنك من خلاله تنزيل الصورة، وهو صالح لفترة محدودة فقط. |
alt |
وصف للصورة التي تظهر عند تمرير مؤشر الماوس فوقها ويقرأها تطبيقات قراءة الشاشة |
properties |
خصائص الصورة |
حقل الربط image_source نوع مصدر الصورة. يجب ضبط حقل مصدر صورة واحد بالضبط عند إنشاء صور جديدة. يمكن أن يكون image_source واحدًا مما يلي فقط: |
|
source |
الإدخال فقط معرّف الموارد المنتظم (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 |
مطلوب. أعلى قيمة ممكنة للمقياس |
low |
التصنيف الذي سيتم عرضه لوصف أدنى نقطة على المقياس |
high |
التصنيف الذي سيتم عرضه لوصف أعلى نقطة على المقياس |
DateQuestion
سؤال حول التاريخ تكون قيمة أسئلة التاريخ التلقائية هي الشهر + اليوم فقط.
تمثيل JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
الحقول | |
---|---|
include |
ما إذا كان سيتم تضمين الوقت كجزء من السؤال |
include |
ما إذا كان يجب تضمين السنة كجزء من السؤال |
TimeQuestion
سؤال حول الوقت
تمثيل JSON |
---|
{ "duration": boolean } |
الحقول | |
---|---|
duration |
|
FileUploadQuestion
سؤال حول تحميل ملف لا تتيح واجهة برمجة التطبيقات حاليًا إنشاء أسئلة لتحميل الملفات.
تمثيل JSON |
---|
{
"folderId": string,
"types": [
enum ( |
الحقول | |
---|---|
folder |
مطلوب. رقم تعريف مجلد Drive الذي يتم تخزين الملفات المحمَّلة فيه |
types[] |
أنواع الملفات المقبولة في هذا السؤال |
max |
الحد الأقصى لعدد الملفات التي يمكن تحميلها لهذا السؤال في ردّ واحد |
max |
الحد الأقصى لعدد البايت المسموح به لأي ملف واحد يتم تحميله إلى هذا السؤال. |
FileType
أنواع الملفات التي يمكن تحميلها إلى سؤال حول تحميل الملفات
عمليات التعداد | |
---|---|
FILE_TYPE_UNSPECIFIED |
القيمة التلقائية غير مستخدَمة |
ANY |
ما مِن قيود على النوع. |
DOCUMENT |
مستند "مستندات Google" |
PRESENTATION |
عرض تقديمي في "العروض التقديمية من Google" |
SPREADSHEET |
جدول بيانات في "جداول بيانات Google" |
DRAWING |
رسم |
PDF |
ملف PDF |
IMAGE |
صورة |
VIDEO |
فيديو |
AUDIO |
ملف صوتي |
RowQuestion
إعدادات سؤال يشكّل جزءًا من مجموعة أسئلة
تمثيل JSON |
---|
{ "title": string } |
الحقول | |
---|---|
title |
مطلوب. عنوان الصفّ الواحد في |
RatingQuestion
سؤال تقييم يتوفّر للمستخدم مجموعة من الرموز للاختيار من بينها.
تمثيل JSON |
---|
{
"ratingScaleLevel": integer,
"iconType": enum ( |
الحقول | |
---|---|
rating |
مطلوب. مستوى مقياس التقييم لسؤال التقييم |
icon |
مطلوب. نوع الرمز المراد استخدامه للتقييم |
RatingIconType
نوع الرمز المراد استخدامه للتقييم
عمليات التعداد | |
---|---|
RATING_ICON_TYPE_UNSPECIFIED |
القيمة التلقائية غير مستخدَمة |
STAR |
رمز نجمة |
HEART |
رمز قلب |
THUMB_UP |
رمز إشارة بالإبهام للأسفل |
وضع العلامات
وضع علامات لسؤال واحد
تمثيل JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
الحقول | |
---|---|
point |
مطلوب. الحد الأقصى لعدد النقاط التي يمكن للمجيب الحصول عليها تلقائيًا مقابل إجابة صحيحة. يجب ألا يكون هذا الرقم سالبًا. |
correct |
مطلوب. مفتاح الإجابة عن السؤال. يتم تلقائيًا وضع الدرجات على الردود استنادًا إلى هذا الحقل. |
when |
الملاحظات المعروضة على الردود الصحيحة لا يمكن ضبط هذه الملاحظات إلا لأسئلة الخيارات المتعدّدة التي تتضمّن إجابات صحيحة. |
when |
الملاحظات المعروضة على الردود غير الصحيحة لا يمكن ضبط هذه الملاحظات إلا لأسئلة الخيارات المتعدّدة التي تتضمّن إجابات صحيحة. |
general |
الملاحظات المعروضة لجميع الإجابات يتم استخدام هذا الإجراء بشكل شائع مع الأسئلة ذات الإجابات القصيرة عندما يريد مالك الاختبار إعلام المشاركين بسرعة بما إذا كانت إجاباتهم صحيحة قبل أن تتاح لهم فرصة تقييمها رسميًا. لا يمكن ضبط الملاحظات العامة على أسئلة الخيارات المتعدّدة التي يتم وضع الدرجات عليها تلقائيًا. |
CorrectAnswers
مفتاح الإجابة عن سؤال معيّن.
تمثيل JSON |
---|
{
"answers": [
{
object ( |
الحقول | |
---|---|
answers[] |
قائمة بالإجابات الصحيحة ويمكن تقييم ردّ على اختبار تلقائيًا استنادًا إلى هذه الإجابات. بالنسبة إلى الأسئلة ذات القيمة الواحدة، يتم وضع علامة على الإجابة الصحيحة إذا كانت تتطابق مع أي قيمة في هذه القائمة (بمعنى آخر، من الممكن أن تكون هناك إجابات صحيحة متعددة). بالنسبة إلى الأسئلة التي تتضمّن قيمًا متعدّدة ( |
CorrectAnswer
إجابة صحيحة واحدة عن سؤال بالنسبة إلى الأسئلة التي تتضمّن قيمًا متعدّدة (CHECKBOX
)، قد تكون هناك حاجة إلى عدّة CorrectAnswer
لتمثيل خيار ردّ صحيح واحد.
تمثيل JSON |
---|
{ "value": string } |
الحقول | |
---|---|
value |
مطلوب. قيمة الإجابة الصحيحة. اطّلِع على مستندات |
QuestionGroupItem
يحدّد سؤالاً يتألّف من أسئلة متعدّدة مجمّعة معًا.
تمثيل JSON |
---|
{ "questions": [ { object ( |
الحقول | |
---|---|
questions[] |
مطلوب. قائمة بالأسئلة التي تنتمي إلى مجموعة الأسئلة هذه يجب أن ينتمي السؤال إلى مجموعة واحدة فقط. قد يؤثر |
image |
الصورة المعروضة ضمن مجموعة الأسئلة فوق الأسئلة المحدّدة |
حقل الربط kind مطلوب. نوع مجموعة الأسئلة الذي يحدّد أنواع الأسئلة المسموح بها وكيفية عرضها يمكن أن يكون kind واحدًا مما يلي فقط: |
|
grid |
مجموعة الأسئلة هي شبكة تتضمّن صفوفًا من أسئلة الخيارات المتعدّدة التي تتشارك الخيارات نفسها. عند ضبط |
شبكة
شبكة من الخيارات (مربّعات اختيار أو مربّعات راديوية) يشكّل كل صف منها سؤالاً منفصلاً يتضمّن كل صف الخيارات نفسها التي تظهر في الأعمدة.
تمثيل JSON |
---|
{
"columns": {
object ( |
الحقول | |
---|---|
columns |
مطلوب. الخيارات التي يشترك فيها كل سؤال في الشبكة بعبارة أخرى، قيم الأعمدة. يُسمح بخيارَي |
shuffle |
إذا كان الخيار |
PageBreakItem
لا يحتوي هذا النوع على أي حقول.
فاصل صفحة يظهر عنوان هذا العنصر ووصفه في أعلى الصفحة الجديدة.
TextItem
لا يحتوي هذا النوع على أي حقول.
عنصر نصي
ImageItem
عنصر يحتوي على صورة
تمثيل JSON |
---|
{
"image": {
object ( |
الحقول | |
---|---|
image |
مطلوب. الصورة المعروضة في العنصر |
VideoItem
عنصر يحتوي على فيديو
تمثيل JSON |
---|
{
"video": {
object ( |
الحقول | |
---|---|
video |
مطلوب. الفيديو المعروض في العنصر |
caption |
النص المعروض أسفل الفيديو |
فيديو
بيانات تمثّل فيديو
تمثيل JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
الحقول | |
---|---|
youtube |
مطلوب. عنوان URL لفيديو على YouTube |
properties |
خصائص الفيديو |
الطُرق |
|
---|---|
|
تغيير النموذج من خلال مجموعة من التعديلات |
|
أنشئ نموذجًا جديدًا باستخدام العنوان الوارد في رسالة النموذج المقدَّمة في الطلب. |
|
الحصول على نموذج |