مقدمه

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

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

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

آشنایی با چرخه حیات تخصیص

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

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

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

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

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

پیاده‌سازی

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

<script src="https://apis.google.com/js/platform.js" a><sync de>f<er/script
g:sharetoclassroom url="http://url-to-s><hare" size=&qu>ot;32"/g:sharetoclassroom

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

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

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

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

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

نوع پست دکمه اشتراک گذاری رابط برنامه‌نویسی کاربردی CourseWork
تکلیف ایکس ایکس
تکلیف مسابقه
سوال: پاسخ کوتاه ایکس ایکس
سوال: چند گزینه ای ایکس ایکس
مواد ایکس ایکس
اطلاعیه ایکس ایکس

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

اصلاح تکالیف

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

رابط برنامه‌نویسی کاربردی CourseWork هم امکان تغییر و حذف تکالیف ایجاد شده در برنامه شما و هم امکان بازیابی جزئیات هرگونه تکلیف ارسال شده به دوره‌های کاربر را فراهم می‌کند. با این حال، توجه به این نکته مهم است که موارد 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ها در کنسول مدیریت و نظارت دقیق‌تر دارد
ایجاد و اشتراک‌گذاری تکالیف
  • معلمان را به کادر گفتگوی اشتراک‌گذاری دکمه اشتراک‌گذاری کلاس درس هدایت می‌کند
  • کاربران می‌توانند همه نوع آیتم به جز یک نوع را پست کنند
  • فیلدهای کمتری را می‌توان مشخص کرد
  • یکی امکان ایجاد تکلیف را فراهم می‌کند، اما امکان دریافت یا تغییر داده‌های تکلیف وجود ندارد.
  • نیازی به دکمه اشتراک گذاری نیست
  • بیشتر فیلدهای تکلیف کلاس درس را می‌توان مشخص کرد
  • امکان تغییر دوره‌های آموزشی ایجاد شده توسط برنامه شما
  • به برنامه شما اجازه می‌دهد تا تمام داده‌های تکلیف را از Classroom دریافت کند
تکمیل و ارسال تکالیف
  • دانش‌آموزان را به کادر گفتگوی اشتراک‌گذاری دکمه اشتراک‌گذاری کلاس درس هدایت می‌کند
  • به دانش‌آموزان اجازه می‌دهد تا مطالب خود را به هر تکلیف کلاسی پیوست کنند
  • یکی از آنها پیوست ارسال را فعال می‌کند، اما امکان دریافت یا تغییر داده‌های ارسال وجود ندارد
  • به دانش‌آموزان اجازه نمی‌دهد تکلیف را تحویل دهند
  • نیازی به دکمه اشتراک گذاری نیست
  • فقط به دانش‌آموزان اجازه می‌دهد تا مطالب خود را به تکالیف ایجاد شده توسط برنامه شما پیوست کنند
  • به برنامه شما اجازه می‌دهد تا مطالب ارسالی دانش‌آموزان ایجاد شده توسط برنامه شما را تغییر دهد
  • به دانش‌آموزان اجازه می‌دهد تکالیف خود را تحویل دهند
بررسی و نمره‌دهی تکالیف هیچ پشتیبانی برای مشخص کردن یا بازگرداندن نمرات وجود ندارد
  • به برنامه شما اجازه می‌دهد تا تمام داده‌های ارسالی دانش‌آموزان را از طرف یک معلم از Classroom دریافت کند
  • امکان اختصاص نمرات دانش آموزان، چه به صورت پیش نویس و چه به صورت نهایی را فراهم می کند.
  • امکان تغییر نمرات دانش آموزان را فراهم می کند
  • امکان بازگرداندن نمرات به دانش‌آموزان را فراهم می‌کند