ادغام CourseWork

توسعه‌دهندگان می‌توانند از Google Classroom API برای تعامل با دوره‌های آموزشی در Google Classroom استفاده کنند. برنامه‌ای که از API به این روش استفاده می‌کند، CourseWork integration نامیده می‌شود.

این مسیر ادغام معمولاً برای ایجاد و نمره‌دهی تکالیف با لینک به منابع خارج از Classroom استفاده می‌شود. این مسیر در مقایسه با دکمه‌های اشتراک‌گذاری Classroom ، دسترسی بیشتری به مدیریت تکالیف برای توسعه‌دهندگان فراهم می‌کند.

چگونه کار می‌کند؟

ویژگی اصلی یکپارچه‌سازی CourseWork ایجاد و مدیریت تکالیف، اطلاعیه‌ها و مطالب درسی با استفاده از Classroom API است.

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

  1. یک کاربر معلم وارد وب‌سایت شما می‌شود.
  2. معلم محتوایی را که می‌خواهد با کلاس خود به اشتراک بگذارد، پیدا یا ایجاد می‌کند. معلم روی دکمه‌ای در وب‌سایت شما کلیک می‌کند تا این محتوا را به Google Classroom ارسال کند.
  3. برنامه شما درخواستی را به courses.courseWork.create ارسال می‌کند. این درخواست شامل یک شیء CourseWork در بدنه خود است که شامل موارد زیر است:
    • شناسه دوره مقصد.
    • عنوان تکلیف.
    • توضیحات متنی برای تکلیف.
    • یک link Material با آدرس اینترنتی (URL) به محتوای انتخاب شده توسط معلم.
    • به صورت اختیاری، حداکثر امتیاز قابل دستیابی برای محتوای انتخاب شده.
  4. یک تکلیف جدید در کلاس درس با یک لینک پیوست ظاهر می‌شود. این لینک به URL مشخص شده در درخواست create اشاره دارد. برای مثال به شکل ۱ مراجعه کنید.
  5. یک ستون جدید برای این تکلیف نیز در دفتر نمرات کلاس درس ظاهر می‌شود که شامل حداکثر نمره در صورت وجود است.
  6. دانش‌آموزان تکلیف را دریافت می‌کنند و روی link Material کلیک می‌کنند تا URL ارائه شده در یک برگه جدید باز شود و محتوای وب‌سایت شما را مشاهده یا تکمیل کنند. در صورت تمایل، کنترل‌هایی را برای دانش‌آموز فراهم کنید تا تکلیف را تحویل دهد .
  7. در صورت تمایل، درخواستی به courses.courseWork.studentSubmissions.modifyAttachments ارسال کنید تا پیوست‌هایی به درخواست دانشجو اضافه شود، مانند یک فایل Google Drive یا link Material که به کار دانشجو در وب‌سایت شما اشاره می‌کند.
  8. در صورت تمایل، درخواستی به courses.courseWork.studentSubmissions.patch ارسال کنید تا نمره دانشجو برای تکلیف تعیین شود.

ویرایش تکلیف دوره آموزشی با پیوست کردن مطالب مرتبط

شکل ۱. نمای معلم هنگام ویرایش یک تکلیف با link Material ایجاد شده توسط یکپارچه‌سازی CourseWork .

به عنوان یک روش جایگزین، می‌توانید برای ایجاد یک اطلاعیه یا محتوای دوره به جای یک تکلیف، از courses.announcements.create یا courses.courseWorkMaterials.create استفاده کنید. برای توضیحات دقیق در مورد اقدامات مربوط به Classroom API، به صفحات Create & manage coursework و Set & update scores مراجعه کنید.

ملاحظات

قبل از تصمیم‌گیری در مورد اینکه آیا یکپارچه‌سازی CourseWork انتخاب مناسبی برای نیازهای محصول شما است یا خیر، موارد زیر را در نظر داشته باشید.

  • شما باید کاربر را تأیید کنید و از او رضایت بخواهید. شما از طرف کاربر درخواست‌های API را ارسال می‌کنید. این بدان معناست که، برای مثال، شما نمی‌توانید در هیچ دوره Google Classroom کار درسی ایجاد کنید؛ شما فقط می‌توانید در دوره‌هایی که کاربر مجاز تدریس می‌کند، کار درسی ایجاد کنید.
  • شما به روشی نیاز دارید که کاربر بتواند برای دریافت محتوا، یک دوره را انتخاب کند. استفاده از courses.list را برای دریافت لیستی از دوره‌های تدریس شده توسط کاربر در نظر بگیرید، سپس به کاربر اجازه دهید یک یا چند دوره را از لیست انتخاب کند.
  • وقتی کاربر روی link Material در کلاس درس» کلیک می‌کند، لینک در یک تب جدید باز می‌شود. سرور شما هنگام باز شدن URL هیچ اطلاعاتی از کلاس درس دریافت نمی‌کند.
  • یک معلم می‌تواند مستقل از توسعه‌دهنده، کار درسی را تغییر دهد یا حذف کند. این بدان معناست که دانش توسعه‌دهنده در مورد کار درسی ممکن است قدیمی شود. اگر نیاز دارید از تغییرات در کار درسی مطلع شوید، تنظیم اعلان‌های فوری برای تغییرات کار درسی را در نظر بگیرید.
  • یک معلم می‌تواند در رابط کاربری Classroom، تکالیف درسی ایجاد کند و لینک‌های آن را به آدرس‌های اینترنتی موجود در وب‌سایت خود الصاق کند. تکالیف درسی ایجاد شده به این روش، صرفاً متعلق به معلم هستند، بنابراین شما قادر به مشاهده، اصلاح یا تنظیم نمرات ارائه شده با استفاده از Classroom API نخواهید بود.