شرکای SIS علاقه‌مند می‌توانند از تست‌های انطباق در GitHub برای تعیین اینکه آیا محصولشان با الزامات مصرف OneRoster Google Classroom مطابقت دارد یا خیر استفاده کنند.
به تست ها دسترسی پیدا کرده و اجرا کنید
برای اجرای تست ها به موارد زیر نیاز دارید:
- نشانی اینترنتی رمز برای بازیابی اطلاعات کاربری OAuth 2.0
- یک URL فهرستی که به
/ims/oneroster/v1p1ختم می‌شود - شناسه مشتری
- راز مشتری
- آدرس ایمیل معلم
با استفاده از Google Colab یا Jupyter notebook می توانید تست ها را اجرا کنید. هر دو نوت بوک کولب و ژوپیتر به شما امکان می دهند همه تست ها را یکجا اجرا کنید. این به شما کمک می‌کند نتایج آزمایش را برای اشتراک‌گذاری با تیم Google Classroom ایجاد کنید.
الزامات SIS و رفتار مورد انتظار
آزمایش‌های تعریف‌شده توسط Google برای ارائه روشی به شرکای SIS علاقه‌مند برای تعیین اینکه آیا محصول آن‌ها الزامات مصرف OneRoster Google را برآورده می‌کند و برای به حداقل رساندن خطاهایی که کاربران ممکن است هنگام استفاده از ادغام‌های SIS در Classroom تجربه کنند، وجود دارد. نکات زیر را در مورد آزمون ها بخوانید. در GitHub، هر آزمون دارای عنوانی است که در اشاره گرها به آن اشاره شده است. به خاطر داشته باشید که اشاره گرها می توانند به روشن شدن سؤالات کمک کنند، اما فهرست جامعی از آزمون ها نیست. مطمئن شوید که تمام تست های ارائه شده در GitHub را اجرا کرده اید.
| تست کنید | اشاره گرها |
|---|---|
| معلمان: GetAllTeachers | نقطه پایانی GET /teachers با یک پارامتر query 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 استفاده می‌شود. |
| LineItem: ایجاد کنید | هنگام تماس با PUT /lineItems/{line_item_sourced_id} دوره های درجه بندی لازم نیست. |
| Line Item: ویرایش | اگر طول عنوان تخصیص طولانی گنجانده شود، تماس API نباید خطایی را نشان دهد. این آزمون شامل یک عنوان تکلیف بیش از 100 کاراکتر است. |
| نتیجه: ویرایش | باید بتوان score را روی مقداری بیشتر از resultValueMax تنظیم کرد تا نشان دهنده اعتبار اضافی باشد. |
| نتیجه: حذف کنید | نقطه پایانی DELETE /results/{result_sourced_id} مورد نیاز است. |
| LineItem (اختیاری / پاکسازی): حذف و دریافت کنید | نقطه پایانی DELETE /lineItems/{line_item_sourced_id} لازم نیست. اختیاری است و برای پاکسازی داده ها استفاده می شود. GET /classes/{class_sourced_id}/lineItems بعدی نیز اختیاری است و آزمایش می‌کند که آیتم خط حذف شده است. |
نتایج آزمون را با تیم Google Classroom به اشتراک بگذارید
پس از اجرای تست ها، یک گزارش کامل با نتایج هر آزمون تولید می شود. این آزمایش‌ها برای تعیین اینکه آیا محصول شما با الزامات مصرف OneRoster 1.1 Google مطابقت دارد یا خیر استفاده می‌شود. برای اشتراک‌گذاری با تیم Google Classroom، گزارش ایجاد شده را دانلود کنید یا از آن عکس بگیرید.
پشتیبانی دریافت کنید
برای هر گونه سوال یا نگرانی به classroom-sis-external@google.com ایمیل بزنید.