- منبع: فرم
- اطلاعات
- تنظیمات فرم
- QuizSettings
- مورد
- مورد سوال
- سوال
- سوال انتخاب
- نوع انتخاب
- گزینه
- GoToAction
- تصویر
- MediaProperties
- هم ترازی
- سوال متنی
- ScaleQuestion
- پرسش تاریخ
- سوال زمان
- FileUploadQuestion
- نوع فایل
- سطر سوال
- درجه بندی
- پاسخ های صحیح
- پاسخ صحیح
- QuestionGroupItem
- توری
- Page BreakItem
- TextItem
- ImageItem
- آیتم ویدیویی
- ویدئو
- مواد و روش ها
منبع: فرم
یک سند Google Forms. فرمی در 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 | این که آیا این فرم یک مسابقه است یا نه. وقتی درست است، پاسخ ها بر اساس |
مورد
یک مورد واحد از فرم. kind
مشخص می کند که چه نوع آیتمی است.
نمایندگی JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
زمینه های | |
---|---|
itemId | شناسه مورد هنگام ایجاد، می توان آن را ارائه کرد، اما شناسه نباید قبلاً در فرم استفاده شود. در صورت عدم ارائه، یک شناسه جدید اختصاص داده می شود. |
title | عنوان مورد. |
description | توضیحات مورد. |
kind میدان اتحادیه . ضروری. نوع مورد این است. kind می تواند تنها یکی از موارد زیر باشد: | |
questionItem | سوالی را برای کاربر مطرح می کند. |
questionGroupItem | با یک اعلان اصلی یک یا چند سوال را برای کاربر مطرح می کند. |
pageBreakItem | صفحه جدیدی را با عنوان شروع می کند. |
textItem | عنوان و توضیحات را در صفحه نمایش می دهد. |
imageItem | تصویری را در صفحه نمایش می دهد. |
videoItem | یک ویدیو را در صفحه نمایش می دهد. |
مورد سوال
یک مورد فرم حاوی یک سوال.
نمایندگی 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 | یک ردیف از |
سوال انتخاب
یک سوال رادیویی / چک باکس / کشویی.
نمایندگی JSON |
---|
{ "type": enum ( |
زمینه های | |
---|---|
type | ضروری. نوع سوال انتخاب |
options[] | ضروری. فهرست گزینه هایی که پاسخ دهنده باید از بین آنها انتخاب کند. |
shuffle | آیا گزینه ها باید به ترتیب تصادفی برای نمونه های مختلف مسابقه نمایش داده شوند یا خیر. این اغلب برای جلوگیری از تقلب توسط پاسخ دهندگانی استفاده می شود که ممکن است به صفحه پاسخ دهنده دیگری نگاه کنند، یا برای مقابله با سوگیری در نظرسنجی که ممکن است با قرار دادن گزینه های یکسان در اول یا آخر معرفی شود. |
نوع انتخاب
نوع انتخاب.
Enums | |
---|---|
CHOICE_TYPE_UNSPECIFIED | مقدار پیش فرض. استفاده نشده |
RADIO | دکمههای رادیویی: همه انتخابها به کاربر نشان داده میشوند که فقط میتواند یکی از آنها را انتخاب کند. |
CHECKBOX | چک باکس ها: همه انتخاب ها به کاربر نشان داده می شود که می تواند هر تعداد از آنها را انتخاب کند. |
DROP_DOWN | منوی کشویی: انتخاب ها فقط به درخواست کاربر نشان داده می شوند، در غیر این صورت فقط انتخاب فعلی نشان داده می شود. فقط یک گزینه را می توان انتخاب کرد. |
گزینه
گزینه ای برای یک سوال انتخاب.
نمایندگی JSON |
---|
{ "value": string, "image": { object ( |
زمینه های | |
---|---|
value | ضروری. انتخابی که به کاربر ارائه شده است. |
image | نمایش تصویر به عنوان یک گزینه |
isOther | این که آیا گزینه "دیگر" است. در حال حاضر فقط برای انواع انتخاب |
فیلد اتحادیه go_to_section . در صورت انتخاب این گزینه به کدام بخش بروید. در حال حاضر فقط برای نوع انتخاب RADIO و SELECT اعمال می شود، اما در QuestionGroupItem مجاز نیست. go_to_section می تواند تنها یکی از موارد زیر باشد: | |
goToAction | نوع ناوبری بخش |
goToSectionId | شناسه مورد هدر بخش برای رفتن به. |
GoToAction
ثابت برای ناوبری بخش.
Enums | |
---|---|
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 یا نامشخص فقط در هنگام به روز رسانی منبع رسانه مجاز است. |
هم ترازی
تراز در صفحه
Enums | |
---|---|
ALIGNMENT_UNSPECIFIED | مقدار پیش فرض. استفاده نشده |
LEFT | تراز چپ. |
RIGHT | تراز راست. |
CENTER | مرکز. |
سوال متنی
یک سوال متنی
نمایندگی JSON |
---|
{ "paragraph": boolean } |
زمینه های | |
---|---|
paragraph | آیا سوال یک سوال پاراگراف است یا نه. اگر نه، سوال یک سوال متنی کوتاه است. |
ScaleQuestion
یک سوال مقیاس کاربر طیف وسیعی از مقادیر عددی را برای انتخاب دارد.
نمایندگی JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
زمینه های | |
---|---|
low | ضروری. کمترین مقدار ممکن برای مقیاس. |
high | ضروری. بالاترین مقدار ممکن برای مقیاس. |
lowLabel | برچسبی که نشان می دهد پایین ترین نقطه مقیاس را توصیف می کند. |
highLabel | برچسبی که بالاترین نقطه مقیاس را توصیف می کند. |
سوال تاریخ
یه سوال تاریخ سوالات تاریخ به طور پیش فرض فقط ماه + روز است.
نمایندگی JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
زمینه های | |
---|---|
includeTime | آیا باید زمان را به عنوان بخشی از سؤال لحاظ کرد یا خیر. |
includeYear | آیا باید سال را به عنوان بخشی از سؤال لحاظ کرد یا خیر. |
سوال زمان
یک سوال زمانی
نمایندگی JSON |
---|
{ "duration": boolean } |
زمینه های | |
---|---|
duration | |
FileUploadQuestion
یک سوال آپلود فایل API در حال حاضر از ایجاد سوالات آپلود فایل پشتیبانی نمی کند.
نمایندگی JSON |
---|
{
"folderId": string,
"types": [
enum ( |
زمینه های | |
---|---|
folderId | ضروری. شناسه پوشه Drive که فایلهای آپلود شده در آن ذخیره میشوند. |
types[] | انواع فایل مورد قبول این سوال. |
maxFiles | حداکثر تعداد فایل هایی که می توان برای این سوال در یک پاسخ آپلود کرد. |
maxFileSize | حداکثر تعداد بایت مجاز برای هر فایلی که در این سوال آپلود شده است. |
نوع فایل
انواع فایلهایی که میتوانند در یک سوال آپلود فایل آپلود شوند.
Enums | |
---|---|
FILE_TYPE_UNSPECIFIED | مقدار پیش فرض. استفاده نشده |
ANY | بدون محدودیت در نوع |
DOCUMENT | یک سند Google Docs. |
PRESENTATION | ارائه Google Slides. |
SPREADSHEET | یک صفحه گسترده Google Sheets. |
DRAWING | یک نقاشی |
PDF | یک پی دی اف. |
IMAGE | یک تصویر. |
VIDEO | یک ویدیو |
AUDIO | یک فایل صوتی |
سطر سوال
پیکربندی برای یک سؤال که بخشی از یک گروه سؤال است.
نمایندگی JSON |
---|
{ "title": string } |
زمینه های | |
---|---|
title | ضروری. عنوان تک ردیف در |
درجه بندی
نمره دهی برای یک سوال
نمایندگی JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
زمینه های | |
---|---|
pointValue | ضروری. حداکثر امتیازی که پاسخ دهنده می تواند به طور خودکار برای یک پاسخ صحیح کسب کند. این نباید منفی باشد. |
correctAnswers | ضروری. کلید پاسخ سوال پاسخ ها به طور خودکار بر اساس این فیلد درجه بندی می شوند. |
whenRight | بازخورد برای پاسخ های صحیح نمایش داده می شود. این بازخورد را فقط میتوان برای سؤالات چند گزینهای تنظیم کرد که دارای پاسخهای صحیح هستند. |
whenWrong | بازخورد برای پاسخ های نادرست نمایش داده می شود. این بازخورد را فقط میتوان برای سؤالات چند گزینهای تنظیم کرد که دارای پاسخهای صحیح هستند. |
generalFeedback | بازخورد برای همه پاسخ ها نمایش داده می شود. این معمولاً برای سؤالات پاسخ کوتاه استفاده میشود، زمانی که صاحب مسابقه میخواهد به سرعت به پاسخدهندگان بفهمد که آیا قبل از اینکه فرصتی برای نمرهدهی رسمی به سؤال داشته باشند، به سؤالات پاسخ صحیح دادهاند یا خیر. بازخورد عمومی را نمی توان برای سؤالات چند گزینه ای با درجه بندی خودکار تنظیم کرد. |
پاسخ های صحیح
کلید پاسخ برای یک سوال
نمایندگی JSON |
---|
{
"answers": [
{
object ( |
زمینه های | |
---|---|
answers[] | لیستی از پاسخ های صحیح پاسخ مسابقه می تواند به طور خودکار بر اساس این پاسخ ها درجه بندی شود. برای سؤالات تک ارزشی، اگر پاسخی با هر مقداری در این لیست مطابقت داشته باشد، به درستی علامت گذاری می شود (به عبارت دیگر، چندین پاسخ صحیح امکان پذیر است). برای سؤالات چند ارزشی ( |
پاسخ صحیح
یک پاسخ صحیح برای یک سوال برای سؤالات چند ارزشی ( CHECKBOX
)، ممکن است به چندین گزینه CorrectAnswer
برای نشان دادن یک گزینه پاسخ صحیح نیاز باشد.
نمایندگی JSON |
---|
{ "value": string } |
زمینه های | |
---|---|
value | ضروری. مقدار پاسخ صحیح برای جزئیات در مورد نحوه قالب بندی انواع مقادیر مختلف، به مستندات |
QuestionGroupItem
سؤالی را تعریف می کند که شامل چندین سؤال است که با هم گروه بندی شده اند.
نمایندگی JSON |
---|
{ "questions": [ { object ( |
زمینه های | |
---|---|
questions[] | ضروری. لیستی از سؤالات متعلق به این گروه سؤال. یک سوال فقط باید متعلق به یک گروه باشد. |
image | تصویری که در گروه سوال بالای سوالات خاص نمایش داده می شود. |
kind میدان اتحادیه . ضروری. نوع گروه سوال، که تعیین می کند چه نوع سوالاتی مجاز هستند و چگونه نمایش داده می شوند. kind می تواند تنها یکی از موارد زیر باشد: | |
grid | گروه سوال یک شبکه با ردیف هایی از سوالات چند گزینه ای است که گزینه های مشابهی دارند. وقتی |
توری
شبکهای از انتخابها (رادیو یا چک باکس) که هر ردیف یک سؤال جداگانه را تشکیل میدهد. هر سطر دارای انتخاب های یکسانی است که به عنوان ستون نشان داده می شود.
نمایندگی JSON |
---|
{
"columns": {
object ( |
زمینه های | |
---|---|
columns | ضروری. انتخاب های به اشتراک گذاشته شده توسط هر سوال در شبکه. به عبارت دیگر، مقادیر ستون ها. فقط انتخابهای |
shuffleQuestions | در صورت |
Page BreakItem
شکستن صفحه عنوان و توضیحات این مورد در بالای صفحه جدید نشان داده شده است.
TextItem
یک آیتم متنی
ImageItem
یک مورد حاوی یک تصویر.
نمایندگی JSON |
---|
{
"image": {
object ( |
زمینه های | |
---|---|
image | ضروری. تصویر نمایش داده شده در آیتم |
آیتم ویدیویی
یک مورد حاوی یک ویدیو.
نمایندگی JSON |
---|
{
"video": {
object ( |
زمینه های | |
---|---|
video | ضروری. ویدئوی نمایش داده شده در آیتم |
caption | متنی که در زیر ویدیو نمایش داده می شود. |
ویدئو
داده هایی که یک ویدیو را نشان می دهد.
نمایندگی JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
زمینه های | |
---|---|
youtubeUri | ضروری. یک URI YouTube. |
properties | ویژگی های یک ویدیو |
مواد و روش ها | |
---|---|
| فرم را با دسته ای از به روز رسانی ها تغییر دهید. |
| با استفاده از عنوان داده شده در پیام فرم ارائه شده در درخواست، یک فرم جدید ایجاد کنید. |
| فرم بگیر |