OneRoster برای سیستم های اطلاعات دانشجویی، OneRoster برای سیستم های اطلاعات دانشجویی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Google Classroom از همگام‌سازی کتاب نمره و وارد کردن فهرست برای تعدادی از سیستم‌های اطلاعات دانش‌آموزی (SIS) سازگار با OneRoster پشتیبانی می‌کند. Google با پلتفرم های SIS که الزامات OneRoster مشخص شده توسط Google را برآورده می کنند، شریک می شود.
مشارکت با Classroom به مدیران این امکان را می‌دهد تا کلاس‌های Classroom خود را با SIS شما متصل کنند.
شکل 1. هنگامی که سیستم‌های اطلاعات دانش‌آموز (SIS) با Classroom همکاری می‌کنند، مدیران می‌توانند SIS را در منوی کشویی انتخاب کنند.
سفر توسعه شریک SIS
اگر علاقه مند به همکاری با Classroom هستید، فرم علاقه مندی را پر کنید.
تیم Classroom مجموعه‌ای از تست‌های انطباق ایجاد کرده است که شرکای SIS علاقه‌مند می‌توانند از آن برای آشنایی با الزامات Google استفاده کنند. می‌توانید قبل از تماس با تیم Classroom، تست‌های انطباق را اجرا کنید تا تعیین کنید محصول شما تا چه حد با الزامات Google مطابقت دارد.
آزمایش‌های تعریف‌شده توسط 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 به اشتراک بگذارید
پس از اجرای تست ها، یک گزارش کامل با نتایج هر آزمون تولید می شود. این آزمایش‌ها برای تعیین اینکه آیا محصول شما با الزامات مصرف Google OneRoster 1.2 مطابقت دارد یا خیر استفاده می‌شود. برای اشتراک‌گذاری با تیم Google Classroom، گزارش ایجاد شده را دانلود کنید یا از آن عکس بگیرید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# OneRoster for Student Information Systems\n\nGoogle Classroom supports gradebook sync and roster import for a number of\nOneRoster-compliant Student Information Systems (SIS). Google partners with SIS\nplatforms that meet Google-specified OneRoster requirements.\n| **Note:** This guide is for SIS platforms that want to integrate with Google Classroom. If you're a teacher or administrator that *uses* a SIS, you can check your [Student Information System's partnership status](//support.google.com/edu/classroom/answer/9356588?sjid=5722900537949084202-NA#partnerships&zippy=%2Ccheck-sis-partnership-status).\n\nPartnering with Classroom provides administrators the ability to\nconnect their Classroom classes with your SIS.\n\n**Figure 1.** When Student Information Systems (SIS) partner with\nClassroom, administrators can choose the SIS in the drop-down.\n\nSIS partner development journey\n-------------------------------\n\nIf you are interested in partnering with Classroom, fill out\nthe [interest form](https://docs.google.com/forms/d/e/1FAIpQLSfHEy9dkwuDpvWghYWaVmgrPS58CL5YXO5f6jB_5dOO-_eotg/viewform).\n\nThe Classroom team has created a set of [conformance tests](//github.com/googleworkspace/oneroster-integration-conformance-tests) that\ninterested SIS partners can use to familiarize themselves with Google's\nrequirements. You have the option of running the conformance tests before\nreaching out to the Classroom team to determine how closely your\nproduct meets Google's requirements.\n\n### Obtain a developer demo domain\n\nYou may want access to a live Google Classroom instance to build and validate\nan integration. Eligible test users need the\n[Plus edition of Google Workspace for Education](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). If you don't have administrator\naccess to a Google Workspace for Education domain with these licenses, complete the steps to [get a\ndeveloper test domain](/workspace/classroom/guides/onboarding/prerequisites#get-developer) and\n[request a demo domain upgrade](/workspace/classroom/guides/onboarding/prerequisites#request-demo). Your domain will\nbe provisioned with 10 Google Workspace for Education Plus licenses.\n\n### Access and run the tests\n\nIn order to run the tests, you need the following:\n\n- Token URL to retrieve OAuth 2.0 credentials\n- One Roster URL ending in `/ims/oneroster/v1p1`\n- Client ID\n- Client secret\n- A teacher email address\n\nYou can run the tests by using [Google Colab](//colab.research.google.com/) or [Jupyter notebook](//docs.jupyter.org/en/latest/running.html). Both Colab\nand Jupyter notebook let you run all tests at once. This helps you generate the\ntest results to [share with the Google Classroom team](#share-test-results).\n| **Important:** Running the conformance tests successfully is not a guarantee that your product will be approved to partner with Google Classroom.\n\nSIS requirements and expected behavior\n--------------------------------------\n\nThe Google-defined tests exist to provide interested SIS partners a way to\ndetermine whether their product meets Google's OneRoster consumption\nrequirements and to minimize errors that users might experience when utilizing\nSIS integrations in Classroom. Read through the following\npointers on the tests. In GitHub, each test has a title that is referenced in\nthe pointers. Keep in mind that the pointers can help clarify questions, but\nit's not a comprehensive list of the tests. Ensure you have run all the tests\nprovided in GitHub.\n| **Important:** The following table includes a few pointers to help you integrate with Classroom. Use the conformance test results to ensure the requirements have been met.\n\n| Test | Pointers |\n|-----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Teachers: GetAllTeachers | The `GET /teachers` endpoint is called with a `limit` query parameter. In subsequent tests, this parameter is used to ensure that your product can support a page size of 10,000. |\n| Teachers: GetAllTeachers with email filter | The `GET /teachers` endpoint is called with a `filter` query parameter used to filter based on a teacher email address. This will use the teacher email address you provided in the Credentials section of the tests. |\n| Classes: GetClassesForTeacher | The `/teachers/{teacher_sourced_id}/classes` endpoint is called with a `filter` query parameter used to filter based on active classes. |\n| Students: GetStudentsForClass | The `GET /classes/{class_sourced_id}/students` endpoint is called. The student email must be returned in the response. |\n| GetGradingPeriodsForTerm | Grading periods support is tested using the `term_sourced_id`. This `term_sourced_id` is used to retrieve the grading periods in the term by calling the `GET terms/{term_sourced_id}/gradingPeriods` endpoint. |\n| LineItem: Create | Grading periods aren't required when calling `PUT /lineItems/{line_item_sourced_id}`. |\n| LineItem: Edit | The API call shouldn't return an error if a long assignment title length is included. The test includes an assignment title length of 100+ characters. |\n| Result: Edit | It should be possible to set the `score` to a value greater than the `resultValueMax` to represent extra credit. |\n| Result: Delete | The `DELETE /results/{result_sourced_id}` endpoint is required. |\n| LineItem (Optional / Cleanup): Delete and Get | The `DELETE /lineItems/{line_item_sourced_id}` endpoint is not required. It is optional and used for data clean-up. The subsquent `GET /classes/{class_sourced_id}/lineItems` endpoint is also optional, and tests that the line item was deleted. |\n\nShare the test results with the Google Classroom team\n-----------------------------------------------------\n\nAfter you run the tests, a full report with the results of each test is\ngenerated. These tests are used to determine whether your product meets Google's\nOneRoster 1.2 consumption requirements. Download or take a screenshot of the\ngenerated report to share with the Google Classroom team.\n\nGet support\n-----------\n\nEmail [classroom-sis-external@google.com](mailto:classroom-sis-external@google.com) with any questions.\n\nLinks\n-----\n\n- [Conformance tests on GitHub](//github.com/googleworkspace/oneroster-integration-conformance-tests)"]]
