REST Resource: forms

{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}

string

النتائج فقط. رقم تعريف النموذج

object (Info)

مطلوب. تمثّل هذه السمة عنوان النموذج ووصفه.

object (FormSettings)

إعدادات النموذج يجب تعديل هذه القيمة من خلال إضافة "UpdateSettingsRequest". ويتم تجاهلها خلال forms.create وUpdateFormInfoRequest.

object (Item)

مطلوب. قائمة بعناصر النموذج، والتي يمكن أن تتضمن عناوين الأقسام والأسئلة والوسائط المضمّنة وما إلى ذلك

string

النتائج فقط. رقم تعريف النسخة السابقة للنموذج. تُستخدَم في WriteControl في طلبات التحديث لتحديد النسخة السابقة التي تستند إليها التغييرات.

قد يتغير تنسيق معرّف النسخة السابقة بمرور الوقت، لذا يجب التعامل معه بشكل غير شفاف. إنّ معرّف النسخة السابقة الذي تم إرجاعه مضمون فقط لمدة 24 ساعة بعد إرجاعه ولا يمكن مشاركته بين المستخدمين. في حال عدم تغيير رقم تعريف النسخة السابقة بين المكالمات، يعني ذلك أنّ النموذج لم يتغير. وفي المقابل، إذا تم تغيير رقم التعريف (للنموذج والمستخدم نفسه)، يعني ذلك عادةً أنّه تم تعديل النموذج. ومع ذلك، قد يرجع تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل التغييرات في تنسيق المعرّف.

string

النتائج فقط. معرّف الموارد المنتظم (URI) للنموذج المطلوب مشاركته مع المجيبين يؤدي هذا إلى فتح صفحة تسمح للمستخدم بإرسال الردود دون تعديل الأسئلة.

string

النتائج فقط. رقم تعريف "جدول بيانات Google" المرتبط الذي يجمع الردود من هذا النموذج (في حال توفّر جدول بيانات Google هذا).

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

مطلوب. عنوان النموذج الذي يظهر للمجيبين.

string

النتائج فقط. عنوان المستند الذي يظهر في Drive. إذا كان الحقل Info.title فارغًا، قد يظهر الرمز documentTitle مكانه في واجهة مستخدم "نماذج Google" وقد يظهر للمجيبين. يمكن ضبط documentTitle عند الإنشاء، ولكن لا يمكن تعديله من خلال طلب تعديل مجمّع. يُرجى استخدام Google Drive API إذا كنت تريد تحديث documentTitle آليًا.

string

تمثّل هذه السمة وصف النموذج.

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

الإعدادات المتعلقة بنماذج الاختبار ووضع الدرجات

{
  "isQuiz": boolean
}

boolean

ما إذا كان هذا النموذج اختبارًا أم لا. عندما تكون القيمة true، يتم وضع درجات للردود استنادًا إلى السؤال Grading. عند ضبط هذه السياسة على "خطأ"، يتم حذف كل سؤال Grading.

{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}

string

معرّف السلعة.

عند الإنشاء، يمكن تقديم رقم التعريف، ولكن يجب ألا يكون سبق استخدامه في النموذج. وفي حال عدم توفيرها، يتم تخصيص رقم تعريف جديد.

string

عنوان السلعة.

string

وصف العنصر.

object (QuestionItem)

طرح سؤال للمستخدم

object (QuestionGroupItem)

يطرح سؤالاً واحدًا أو أكثر للمستخدم من خلال طلب رئيسي واحد.

object (PageBreakItem)

يؤدي النقر على هذا الزر إلى بدء صفحة جديدة بعنوان.

object (TextItem)

تعرض عنوانًا ووصفًا على الصفحة.

object (ImageItem)

عرض صورة على الصفحة

object (VideoItem)

عرض فيديو على الصفحة

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

مطلوب. السؤال المعروض.

object (Image)

الصورة المعروضة داخل السؤال.

{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  }
  // End of list of possible types for union field kind.
}

string

للقراءة فقط. رقم تعريف السؤال

عند الإنشاء، يمكن تقديم رقم التعريف، ولكن يجب ألا يكون سبق استخدامه في النموذج. وفي حال عدم توفيرها، يتم تخصيص رقم تعريف جديد.

boolean

لتحديد ما إذا كان يجب الإجابة عن السؤال لكي يتمكّن المجيب من إرسال ردّه.

object (Grading)

إعداد وضع الدرجات للسؤال

object (ChoiceQuestion)

يمكن للمستجيب الاختيار من بين مجموعة محددة مسبقًا من الخيارات.

object (TextQuestion)

يمكن للمجيب إدخال نص حر.

object (ScaleQuestion)

يمكن للمجيب اختيار رقم من نطاق.

object (DateQuestion)

يمكن للمجيب إدخال تاريخ.

object (TimeQuestion)

يمكن للمجيب إدخال وقت.

object (FileUploadQuestion)

يمكن للمجيب تحميل ملف واحد أو أكثر.

object (RowQuestion)

هذه السمة تعرض صفًا من QuestionGroupItem.

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

مطلوب. تمثّل هذه السمة نوع السؤال الذي تختاره.

object (Option)

مطلوب. قائمة الخيارات التي يجب أن يختار المجيب من بينها.

boolean

ما إذا كان يجب عرض الخيارات بترتيب عشوائي لمثيلات مختلفة من الاختبار. غالبًا ما يستخدم هذا لمنع الغش من قبل المشاركين الذين قد ينظرون إلى شاشة مشارك آخر، أو لمعالجة التحيز في استبيان قد يتم تقديمه من خلال وضع نفس الخيارات دائمًا أولاً أو في النهاية.

{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}

string

مطلوب. الاختيار كما تم عرضه للمستخدم.

object (Image)

عرض الصورة كخيار

boolean

تحديد ما إذا كان الخيار "غير ذلك" ينطبق حاليًا على نوعَي الاختيار RADIO وCHECKBOX فقط، ولكن لا يُسمح به في QuestionGroupItem.

enum (GoToAction)

نوع التنقّل في القسم

string

رقم تعريف العنصر لرأس القسم المطلوب الانتقال إليه.

{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}

string

النتائج فقط. معرف موارد منتظم (URI) الذي يمكنك تنزيل الصورة منه يسري هذا العرض لفترة محدودة فقط.

string

وصف الصورة الذي يظهر عند التمرير وتتم قراءته بواسطة برامج قراءة الشاشة.

object (MediaProperties)

خصائص الصورة

string

الإدخال فقط. معرف الموارد المنتظم (URI) المصدر هو معرف الموارد المنتظم (URI) المستخدم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (URI) المصدر فارغًا عند استرجاعه.

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

موضع الوسائط

integer

عرض الوسائط بالبكسل. وعند عرض الوسائط، يتم تغيير حجمها إلى أصغر هذه القيمة أو عرض النموذج المعروض. يتم الاحتفاظ بنسبة العرض إلى الارتفاع الأصلية للوسائط. إذا لم يتم تحديد عرض عند إضافة الوسائط إلى النموذج، يتم ضبطه على عرض مصدر الوسائط. يجب أن يتراوح العرض بين 0 و740، بما في ذلك الرقمان. لا يُسمح بضبط العرض على 0 أو غير محدَّد إلا عند تعديل مصدر الوسائط.

{
  "paragraph": boolean
}

boolean

ما إذا كان السؤال مقطعًا من فقرة أم لا. إذا لم يكن الأمر كذلك، يكون السؤال سؤالاً نصيًا قصيرًا.

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

مطلوب. تمثّل هذه السمة أدنى قيمة ممكنة للمقياس.

integer

مطلوب. تمثّل هذه السمة أعلى قيمة ممكنة للمقياس.

string

التصنيف المطلوب عرضه، وهو يصف النقطة الأدنى على المقياس.

string

التسمية المطلوب عرضها والتي تصف أعلى نقطة على المقياس.

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

تحديد ما إذا كان يجب تضمين الوقت كجزء من السؤال.

boolean

تحديد ما إذا كان سيتم تضمين السنة كجزء من السؤال.

{
  "duration": boolean
}

boolean

true إذا كان السؤال يتعلق بوقت ينقضي. وبخلاف ذلك، يكون الوقت في اليوم تقريبًا.

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

مطلوب. رقم تعريف مجلد Drive الذي يتم تخزين الملفات المحمَّلة فيه

enum (FileType)

أنواع الملفات المقبولة في هذا السؤال.

integer

الحدّ الأقصى لعدد الملفات التي يمكن تحميلها لهذا السؤال في إجابة واحدة.

string (int64 format)

الحد الأقصى لعدد وحدات البايت المسموح بها لأي ملف واحد تم تحميله لهذا السؤال.

{
  "title": string
}

string

مطلوب. تمثّل هذه السمة عنوان الصف الفردي في QuestionGroupItem.

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

مطلوب. الحد الأقصى لعدد النقاط التي يمكن أن يحصل عليها المجيب تلقائيًا للحصول على إجابة صحيحة. يجب ألا يكون هذا سلبيًا.

object (CorrectAnswers)

مطلوب. تمثّل هذه السمة مفتاح الإجابة الخاص بالسؤال. يتم وضع درجات للردود تلقائيًا استنادًا إلى هذا الحقل.

object (Feedback)

الملاحظات المعروضة للردود الصحيحة يمكن ضبط هذه الملاحظات فقط لأسئلة الخيارات المتعدّدة التي تم تقديم الإجابات الصحيحة لها.

object (Feedback)

الملاحظات المعروضة على الردود غير الصحيحة يمكن ضبط هذه الملاحظات فقط لأسئلة الخيارات المتعدّدة التي تم تقديم الإجابات الصحيحة لها.

object (Feedback)

الملاحظات المعروضة لجميع الإجابات. يشيع استخدام هذا للأسئلة ذات الإجابات القصيرة عندما يريد مالك الاختبار إعطاء المستجيبين بسرعة فكرة عما إذا كانوا قد أجابوا عن السؤال بشكل صحيح قبل أن تتاح لهم فرصة تقييم الإجابة رسميًا. لا يمكن ضبط الملاحظات العامة لأسئلة الخيارات المتعدّدة التي تم وضع درجات لها تلقائيًا.

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

تمثّل هذه السمة قائمة بالإجابات الصحيحة. يمكن وضع درجات لأي إجابة اختبار تلقائيًا بناءً على هذه الإجابات. بالنسبة إلى الأسئلة ذات القيمة المفردة، يتم وضع علامة "صحيح" على الإجابة إذا تطابقت مع أي قيمة في هذه القائمة (بمعنى آخر، من الممكن تقديم إجابات متعددة صحيحة). بالنسبة إلى الأسئلة متعددة القيم (CHECKBOX)، يتم وضع علامة "صحيح" على الإجابة إذا كان يحتوي على القيم الموجودة في هذه القائمة بالضبط.

{
  "value": string
}

string

مطلوب. قيمة الإجابة الصحيحة. راجِع مستندات TextAnswer.value للحصول على تفاصيل حول كيفية تنسيق أنواع القيم المختلفة.

{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}

object (Question)

مطلوب. قائمة بالأسئلة التي تنتمي إلى مجموعة الأسئلة هذه يجب أن ينتمي السؤال إلى مجموعة واحدة فقط. قد تؤثر kind للمجموعة في أنواع الأسئلة المسموح بها.

object (Image)

الصورة المعروضة داخل مجموعة الأسئلة فوق الأسئلة المحددة

object (Grid)

مجموعة الأسئلة عبارة عن شبكة تحتوي على صفوف من أسئلة الخيارات المتعددة تشترك في نفس الخيارات. عند ضبط السمة grid، يجب أن تكون جميع الأسئلة في المجموعة من النوع row.

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

مطلوب. الخيارات التي يشاركها كل سؤال في الشبكة. بمعنى آخر، قيم الأعمدة. يُسمح فقط باختيارات CHECK_BOX وRADIO.

boolean

إذا كانت القيمة true، سيتم ترتيب الأسئلة بشكل عشوائي. بمعنى آخر، تظهر الصفوف بترتيب مختلف لكل مشارك.

{
  "image": {
    object (Image)
  }
}

object (Image)

مطلوب. الصورة المعروضة في السلعة

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

مطلوب. تمثّل هذه السمة الفيديو المعروض في السلعة.

string

النص المعروض أسفل الفيديو.

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

مطلوب. معرّف الموارد المنتظم (URI) الخاص بـ YouTube

object (MediaProperties)

خصائص الفيديو