مقدمه

تکالیف در Classroom آیتم‌های CourseWork نامیده می‌شوند که می‌توان آن‌ها را در صفحه Classwork هر دوره Classroom پیدا کرد. در حالی که چهار نوع آیتم کار کلاسی وجود دارد، این راهنما فقط بر نوع "تکلیف" تمرکز دارد. اگر می‌خواهید درباره نحوه مدیریت سایر انواع کار کلاسی بیاموزید، راهنمای مدیریت کار کلاسی ما را بخوانید.

Google Classroom دو راه برای ادغام با گردش کار تکالیف دارد: دکمه اشتراک‌گذاری Classroom و Classroom API . دکمه اشتراک‌گذاری کاربران را قادر می‌سازد تا محتوا را به‌عنوان هر مورد جریانی از طریق یک گفتگوی بازشو Classroom به اشتراک بگذارند، در حالی که API Classroom یک جریان کاری تکالیف از ابتدا تا انتها را فعال می‌کند که شامل ایجاد تکالیف، ایجاد و مدیریت ارسال‌های دانش‌آموز، و پس زدن نمره است.

در اینجا تفاوت های کلیدی بین این دو پیشنهاد توسعه دهنده را بررسی خواهیم کرد. به طور خاص، ما از طریق تفاوت در اجرا و هر مرحله از چرخه حیات تکلیف کار خواهیم کرد: ایجاد تکلیف، ارسال‌های دانش‌آموز، و درجه‌بندی/بازخورد.

درک چرخه عمر تکلیف

قبل از اینکه به تفاوت‌های بین دکمه اشتراک‌گذاری و CourseWork API بپردازیم، اجازه دهید ابتدا آنچه را که به عنوان چرخه زندگی یک تکلیف در زمینه Classroom در نظر می‌گیریم، تعریف کنیم. این به شما کمک می‌کند تا درک کنید که معلمان و دانش‌آموزان چگونه با تکالیف در Classroom تعامل دارند.

پنج مرحله اصلی وجود دارد که باید هنگام ادغام با تکالیف Classroom در نظر داشته باشید:

  1. تکلیف ایجاد می شود.
  2. تکلیف با دانش آموزان به اشتراک گذاشته می شود.
  3. دانش آموز تکلیف را کامل می کند.
  4. دانش آموز تکلیف خود را به معلم می دهد.
  5. بررسی معلمان و تکالیف نمرات.

ادغام با تکالیف Classroom به معلمان و دانش آموزان این امکان را می دهد که بین Classroom و برنامه های شخص ثالث به طور یکپارچه کار کنند. به جای مدیریت جزئیات یک تکلیف یا ارسالی دانش‌آموز، کاربران می‌توانند برای مدیریت این جزئیات به برنامه شما اعتماد کنند.

نموداری که پنج مرحله یک تکلیف را نشان می دهد

پیاده سازی

اولین زمینه تفاوت بین دکمه اشتراک گذاری و CourseWork API پیاده سازی است. از منظر توسعه‌دهنده، دکمه اشتراک‌گذاری روش ساده‌تری برای اشتراک‌گذاری محتوا در Classroom است، زیرا فقط به گنجاندن منبع جاوا اسکریپت ضروری و افزودن برچسب دکمه اشتراک‌گذاری نیاز دارد. در ساده‌ترین شکل، ادغام دکمه اشتراک‌گذاری Classroom شما می‌تواند شبیه قطعه زیر باشد:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

از سوی دیگر، CourseWork API بخشی از Google Classroom API REST API است که نیاز به راه‌اندازی و فعال کردن کلیدهای API با کنسول Google Cloud و پیروی از بهترین روش‌ها برای ادغام با یک API دارد. اگر پلتفرم شما قبلاً از سایر عملکردهای Classroom API مانند فهرست‌بندی استفاده می‌کند، این موضوع کمتر نگران کننده است.

ایجاد و به اشتراک گذاری تکالیف

در حالی که هم دکمه اشتراک‌گذاری و هم CourseWork API دو مرحله اول گردش کار تکلیف، ایجاد و اشتراک‌گذاری تکلیف با دانش‌آموزان را فعال می‌کنند، برخی تفاوت‌های اساسی وجود دارد که باید قبل از انتخاب راه‌حل در نظر بگیرید.

در هسته خود، هر دو راه حل امکان ارسال پیوندها یا فایل ها را به عنوان تکالیف به Classroom فراهم می کنند. این به عنوان یک گردش کار قدرتمند برای معلمانی عمل می کند که در غیر این صورت مجبور می شوند در جریان کار کپی و جایگذاری بین Classroom و برنامه شخص ثالث شرکت کنند. در حالی که هر دو راه حل از توانایی ارسال محتوا به عنوان یک تکلیف پشتیبانی می کنند، باید در نظر بگیرید که آیا برنامه شما به انعطاف پذیری ارسال این محتوا به عنوان سایر انواع کار کلاسی یا حتی یک اعلان نیاز دارد یا خیر.

هر دو پیشنهاد همه انواع پست های Classroom را به جز تکالیف امتحانی نشان می دهند. خلاصه ای از انواع پست ها و اینکه آیا آنها در معرض نمایش قرار می گیرند را می توانید در زیر مشاهده کنید.

نوع پست دکمه اشتراک گذاری CourseWork API
تکلیف X X
تکلیف آزمون
سوال: پاسخ کوتاه X X
سوال: چند گزینه ای X X
مواد X X
اعلامیه X X

عملکردهایی مانند مشخص کردن عنوان و توضیحات نیز می تواند توسط برنامه شما برای هر دو راه حل مشخص شود. در حالی که ادغام دکمه اشتراک‌گذاری به کاربران اجازه می‌دهد تا فیلدهایی مانند تاریخ سررسید، موضوع، حالت فردی و تعداد نقاط را در گفتگوی پاپ‌آپ تنظیم کنند، اما نمی‌توان آنها را به صورت برنامه‌ریزی توسط یک برنامه شخص ثالث تنظیم کرد. از طرف دیگر API همه این فیلدها را برای دسترسی خواندن و نوشتن در معرض دید قرار می دهد.

اصلاح تکالیف

یکی از مزایای ادغام با Classroom API حذف نیاز به همگام سازی دستی کاربران برای تغییر جزئیات تکالیف است. دکمه اشتراک‌گذاری فاقد قابلیت به‌روزرسانی یا حذف تکالیف به‌صورت برنامه‌ای است، بنابراین هر گونه تغییر مورد نیاز باید توسط کاربر از طریق رابط کاربری کلاس روم انجام شود.

CourseWork API امکان تغییر و حذف تکالیف ایجاد شده توسط برنامه شما و همچنین امکان بازیابی جزئیات تکالیف ارسال شده در دوره های کاربر را فراهم می کند. با این حال، توجه به این نکته مهم است که موارد CourseWork که توسط همان کنسول توسعه‌دهنده ایجاد نشده‌اند ، توسط آن کنسول توسعه‌دهنده قابل تغییر نیستند. این مدل مجوز به بقیه چرخه عمر تکلیف گسترش می‌یابد، به عنوان مثال مدیریت ارسال‌های دانش‌آموز و نمرات، برای این موارد CourseWork قابل دسترسی نیست.

همگام سازی خودکار تکالیف

با اعلان‌های فشار Pub/Sub، برنامه شما می‌تواند در اعلان‌هایی مشترک شود که وقتی تغییراتی در موارد CourseWork و ارسال‌های دانشجوی مرتبط با آن ایجاد می‌شود، رویدادی را راه‌اندازی می‌کنند. این به برنامه شما اجازه می دهد تا با حذف نیاز به بررسی مداوم برای مشاهده اینکه آیا محتوا در Classroom به روز شده است یا خیر، تکالیف را به راحتی همگام سازی کند.

تکمیل و ارسال تکالیف

هر تکلیف با N ارسالی دانش آموز همراه است، که در آن N تعداد دانش آموزانی است که تکلیف به آنها اختصاص داده شده است. به عبارت دیگر، برای هر تکلیف، یک ارسال دانشجو برای هر دانش آموز وجود دارد - که با یک شناسه منحصر به فرد قابل دسترسی است. این مطالب ارسالی دانش‌آموز به‌طور خودکار ایجاد می‌شوند و می‌توانند توسط برنامه شما با نقطه‌های پایانی GET و LIST ارسال‌های دانشجویی بازیابی شوند.

هم دکمه اشتراک‌گذاری و هم CourseWork API از افزودن پیوندها یا فایل‌ها به مطالب ارسالی دانش‌آموز برای تکلیف پشتیبانی می‌کنند. دکمه اشتراک گذاری این امکان را از طریق یک گردش کاری مشابه به عنوان گفتگوی ایجاد تکالیف معلم و CourseWork API از طریق نقطه پایان studentSubmissions.modifyAttachments می دهد. با این حال، به دلیل محدودیت‌های مجوز API که قبلاً توضیح داده شد، این عملکرد محدود به موارد CourseWork است که برنامه شما ایجاد کرده است. همین محدودیت برای دکمه اشتراک‌گذاری صادق نیست - دانش‌آموزان می‌توانند کار خود را به هر تکلیفی که از Classroom انتخاب می‌کنند اضافه کنند.

پایان دادن به گردش کار دانشجویی

در حالی که محدودیت مجوز CourseWork برای پلتفرم‌هایی که از ایجاد تکلیف پشتیبانی نمی‌کنند، مورد استفاده قرار نمی‌گیرد، یک مزیت این است که پلتفرم‌های شخص ثالث می‌توانند مانع از ارسال دانش‌آموزان به تکلیف نادرست و فراموش کردن تحویل کارشان شوند زیرا فقط دکمه اشتراک‌گذاری است. محدود به توانایی دانش آموزان برای تحویل تکالیف است.

بررسی و نمره دهی تکالیف

آخرین بخش از چرخه زندگی تکلیف به معلم برمی گردد. وقتی دانش‌آموزان تکالیف خود را با موفقیت انجام دادند، معلم اکنون می‌تواند تکلیف را به هر شکلی که منطقی‌تر است مرور کند. در مورد فایل‌هایی که در Drive ذخیره شده‌اند، می‌توانند مستقیماً در درجه‌بندی Classroom مرور کنند. با این حال، برنامه های شخص ثالث در کلاس Classroom قابل دسترسی نیستند. مفهوم این تجربه این است که معلمان باید چندین برگه را در حین بررسی و نمره دهی تکالیف مرور کنند.

دکمه اشتراک گذاری در حال حاضر هیچ راه حلی برای درجه بندی و برگرداندن تکالیف ارائه نمی دهد. در حالی که ویژگی‌هایی مانند نظرات ارسال دانش‌آموز در حال حاضر از طریق API نمایش داده نمی‌شوند، هم رتبه‌بندی و هم برگرداندن آن نمرات به دانش‌آموزان از طریق نقاط پایانی studentSubmissions.patch و studentSubmissions.return امکان‌پذیر است. نمرات را می توان فقط برای آیتم های جریان CourseWork (انواع تکلیف و سؤال) مشخص کرد. آنها فقط به صورت عددی در دسترس هستند و می توانند به عنوان پیش نویس یا نمره نهایی اختصاص داده شوند.

خلاصه تفاوت ها

برای خلاصه کردن همه چیزهایی که در بخش‌های قبلی مرور شد، جدول زیر مقایسه‌ای کنار هم از دکمه اشتراک‌گذاری و CourseWork API برای چهار دسته‌ای که در بالا مورد بحث قرار گرفت را نشان می‌دهد: پیاده‌سازی، ایجاد و اشتراک‌گذاری تکالیف، تکمیل و ارسال تکالیف، و بررسی و درجه‌بندی. تکالیف

دکمه اشتراک گذاری CourseWork API
پیاده سازی فقط چند خط جاوا اسکریپت که پیاده سازی را ساده و سریع می کند به تنظیم کلیدهای API، فعال کردن APIها در کنسول مدیریت و نظارت دقیق‌تر نیاز دارد.
ایجاد و به اشتراک گذاری تکالیف
  • معلمان را به گفتگوی اشتراک گذاری دکمه اشتراک گذاری Classroom هدایت می کند
  • کاربران می توانند همه موارد به جز یک جریان را پست کنند
  • فیلدهای کمتری را می توان مشخص کرد
  • یکی ایجاد تخصیص را قادر می‌سازد، بدون توانایی کشیدن یا تغییر داده‌های انتساب
  • بدون نیاز به گفتگوی دکمه اشتراک گذاری
  • بیشتر فیلدهای تکلیف کلاس را می توان مشخص کرد
  • امکان تغییر دروس ایجاد شده توسط برنامه شما
  • به برنامه شما اجازه می‌دهد همه داده‌های تکلیف را از Classroom بیرون بکشد
تکمیل و ارسال تکالیف
  • دانش‌آموزان را به گفتگوی اشتراک‌گذاری دکمه اشتراک‌گذاری Classroom هدایت می‌کند
  • به دانش‌آموزان اجازه می‌دهد تا مطالب ارسالی خود را به هر تکلیف کلاس درس پیوست کنند
  • یکی ضمیمه ارسال را فعال می کند، بدون توانایی برای کشیدن یا تغییر داده های ارسالی
  • به دانش آموزان اجازه نمی دهد تکلیف را تحویل دهند
  • بدون نیاز به گفتگوی دکمه اشتراک گذاری
  • فقط به دانش‌آموزان اجازه می‌دهد موارد ارسالی خود را به تکالیف ایجاد شده توسط برنامه شما پیوست کنند
  • به برنامه شما اجازه می‌دهد تا مطالب ارسالی دانش‌آموز ایجاد شده توسط برنامه شما را تغییر دهد
  • به دانش آموزان اجازه می دهد تا تکالیف خود را انجام دهند
بررسی و نمره دهی تکالیف هیچ پشتیبانی برای مشخص کردن یا بازگشت نمرات
  • به برنامه شما اجازه می‌دهد همه داده‌های ارسالی دانش‌آموز را از Classroom از طرف معلم بیرون بکشد
  • توانایی تخصیص نمرات دانش آموز را به صورت پیش نویس یا نهایی نشان می دهد
  • توانایی تغییر نمرات دانش آموزان را نشان می دهد
  • توانایی بازگرداندن نمرات را به دانش آموزان نشان می دهد