ادغام CourseWork

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

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

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

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

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

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

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

از طرف دیگر، می‌توانید courses.announcements.create یا courses.courseWorkMaterials.create را فراخوانی کنید تا به‌جای تکلیف، یک اطلاعیه یا مطالب دوره ایجاد کنید. برای توضیحات دقیق اقدامات مربوط به API Classroom، به صفحات ایجاد و مدیریت دوره آموزشی و تنظیم و به‌روزرسانی نمرات مراجعه کنید.

ملاحظات

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

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