گوگل کلاسروم از همگامسازی دفتر نمرات و وارد کردن فهرست برای تعدادی از سیستمهای اطلاعات دانشآموزی (SIS) سازگار با OneRoster پشتیبانی میکند. گوگل با پلتفرمهای SIS که الزامات OneRoster مشخصشده توسط گوگل را برآورده میکنند، همکاری میکند.
همکاری با Classroom به مدیران این امکان را میدهد که کلاسهای Classroom خود را به SIS شما متصل کنند.
شکل ۱. وقتی سیستمهای اطلاعات دانشجویی (SIS) با Classroom همکاری میکنند، مدیران میتوانند SIS را از منوی کشویی انتخاب کنند.
سفر توسعه شریک SIS
اگر علاقهمند به همکاری با Classroom هستید، فرم علاقهمندی را پر کنید.
تیم Classroom مجموعهای از تستهای انطباق را ایجاد کرده است که شرکای SIS علاقهمند میتوانند از آنها برای آشنایی با الزامات گوگل استفاده کنند. شما میتوانید قبل از تماس با تیم Classroom، تستهای انطباق را اجرا کنید تا مشخص شود محصول شما تا چه حد با الزامات گوگل مطابقت دارد.
یک دامنه آزمایشی توسعهدهنده دریافت کنید
ممکن است برای ساخت و اعتبارسنجی یکپارچهسازی، به یک نمونه زنده Google Classroom نیاز داشته باشید. کاربران آزمایشی واجد شرایط به نسخه Plus از Google Workspace for Education نیاز دارند. اگر با این مجوزها به دامنه Google Workspace for Education دسترسی مدیریتی ندارید، مراحل دریافت دامنه آزمایشی توسعهدهندگان و درخواست ارتقاء دامنه آزمایشی را تکمیل کنید. دامنه شما با 10 مجوز Google Workspace for Education Plus تأمین خواهد شد.
دسترسی و اجرای تستها
برای اجرای تستها، به موارد زیر نیاز دارید:
- URL توکن برای بازیابی اعتبارنامههای OAuth 2.0
- یک آدرس اینترنتی فهرست که به
/ims/oneroster/v1p1ختم میشود - شناسه مشتری
- راز مشتری
- آدرس ایمیل یک معلم
شما میتوانید تستها را با استفاده از Google Colab یا Jupyter notebook اجرا کنید. هم Colab و هم Jupyter notebook به شما امکان میدهند همه تستها را یکجا اجرا کنید. این به شما کمک میکند تا نتایج تست را برای اشتراکگذاری با تیم Google Classroom تولید کنید.
الزامات SIS و رفتار مورد انتظار
آزمونهای تعریفشده توسط گوگل به این منظور وجود دارند که به شرکای علاقهمند SIS راهی برای تعیین اینکه آیا محصولشان الزامات مصرف OneRoster گوگل را برآورده میکند یا خیر، ارائه دهند و خطاهایی را که کاربران ممکن است هنگام استفاده از ادغامهای SIS در Classroom با آن مواجه شوند، به حداقل برسانند. نکات زیر را در مورد آزمونها مطالعه کنید. در GitHub، هر آزمون عنوانی دارد که در اشارهگرها به آن اشاره شده است. به خاطر داشته باشید که اشارهگرها میتوانند به روشن شدن سوالات کمک کنند، اما این یک لیست جامع از آزمونها نیست. مطمئن شوید که تمام آزمونهای ارائه شده در GitHub را اجرا کردهاید.
| تست | اشارهگرها |
|---|---|
| معلمان: GetAllTeachers | نقطه پایانی GET /teachers با یک پارامتر کوئری limit فراخوانی میشود. در آزمایشهای بعدی، از این پارامتر برای اطمینان از اینکه محصول شما میتواند از اندازه صفحه ۱۰۰۰۰ پشتیبانی کند، استفاده میشود. |
| معلمان: GetAllTeachers با فیلتر ایمیل | نقطه پایانی GET /teachers با یک پارامتر پرس و جوی filter فراخوانی میشود که برای فیلتر کردن بر اساس آدرس ایمیل معلم استفاده میشود. این از آدرس ایمیل معلمی که شما در بخش اعتبارنامههای آزمونها ارائه کردهاید، استفاده خواهد کرد. |
| کلاسها: GetClassesForTeacher | نقطه پایانی /teachers/{teacher_sourced_id}/classes با یک پارامتر پرسوجوی filter فراخوانی میشود که برای فیلتر کردن بر اساس کلاسهای فعال استفاده میشود. |
| دانشآموزان: GetStudentsForClass | نقطه پایانی GET /classes/{class_sourced_id}/students فراخوانی میشود. ایمیل دانشجو باید در پاسخ برگردانده شود. |
| GetGradingPeriodsForTerm | پشتیبانی از دورههای درجهبندی با استفاده از term_sourced_id آزمایش میشود. این term_sourced_id برای بازیابی دورههای درجهبندی در اصطلاح با فراخوانی نقطه پایانی GET terms/{term_sourced_id}/gradingPeriods استفاده میشود. |
| آیتم خط: ایجاد | هنگام فراخوانی PUT /lineItems/{line_item_sourced_id} دورههای درجهبندی لازم نیست. |
| مورد خط: ویرایش | اگر طول عنوان تکلیف طولانی باشد، فراخوانی API نباید خطایی برگرداند. این تست شامل طول عنوان تکلیف بیش از ۱۰۰ کاراکتر است. |
| نتیجه: ویرایش | باید بتوان score را روی مقداری بزرگتر از resultValueMax تنظیم کرد تا امتیاز اضافی را نشان دهد. |
| نتیجه: حذف | نقطه پایانی DELETE /results/{result_sourced_id} الزامی است. |
| LineItem (اختیاری / پاکسازی): حذف و دریافت | نقطه پایانی DELETE /lineItems/{line_item_sourced_id} الزامی نیست. این نقطه اختیاری است و برای پاکسازی دادهها استفاده میشود. نقطه پایانی GET /classes/{class_sourced_id}/lineItems بعدی نیز اختیاری است و بررسی میکند که آیتم خط حذف شده است. |
نتایج آزمون را با تیم Google Classroom به اشتراک بگذارید
پس از اجرای تستها، یک گزارش کامل با نتایج هر تست ایجاد میشود. این تستها برای تعیین اینکه آیا محصول شما الزامات مصرف OneRoster 1.2 گوگل را برآورده میکند یا خیر، استفاده میشوند. گزارش تولید شده را دانلود کنید یا از آن اسکرینشات بگیرید تا با تیم Google Classroom به اشتراک بگذارید.
دریافت پشتیبانی
برای هرگونه سوال به classroom-sis-external@google.com ایمیل بزنید.