Google 클래스룸은 여러 OneRoster 호환 학생 정보 시스템 (SIS)의 성적 기록 동기화 및 출석부 가져오기를 지원합니다. Google은 Google에서 지정한 OneRoster 요구사항을 충족하는 SIS 플랫폼과 파트너십을 맺고 있습니다.
클래스룸과 파트너십을 맺으면 관리자가 클래스룸 수업을 SIS에 연결할 수 있습니다.
그림 1. 학생 정보 시스템 (SIS)이 클래스룸과 파트너 관계를 맺으면 관리자가 드롭다운에서 SIS를 선택할 수 있습니다.
SIS 파트너 개발 여정
Classroom과의 파트너십에 관심이 있다면 관심 양식을 작성해 주세요.
클래스룸팀은 관심 있는 SIS 파트너가 Google의 요구사항을 숙지하는 데 사용할 수 있는 적합성 테스트를 만들었습니다. 클래스룸팀에 문의하기 전에 적합성 테스트를 실행하여 제품이 Google의 요구사항을 얼마나 충족하는지 확인할 수 있습니다.
개발자 데모 도메인 획득
통합을 빌드하고 검증하려면 실제 Google 클래스룸 인스턴스에 액세스해야 할 수 있습니다. 자격 요건을 충족하는 테스트 사용자에게는 Google Workspace for Education Plus 버전이 필요합니다. 이러한 라이선스가 있는 Google Workspace for Education 도메인에 대한 관리자 액세스 권한이 없는 경우 단계를 완료하여 개발자 테스트 도메인을 획득하고 데모 도메인 업그레이드를 요청하세요. 도메인에 Google Workspace for Education Plus 라이선스 10개가 프로비저닝됩니다.
테스트 액세스 및 실행
테스트를 실행하려면 다음이 필요합니다.
- OAuth 2.0 사용자 인증 정보를 가져오는 토큰 URL
/ims/oneroster/v1p1로 끝나는 OneRoster URL- 클라이언트 ID
- 클라이언트 보안 비밀번호
- 교사 이메일 주소
Google Colab 또는 Jupyter 노트북을 사용하여 테스트를 실행할 수 있습니다. Colab과 Jupyter 노트북 모두 한 번에 모든 테스트를 실행할 수 있습니다. 이를 통해 Google 클래스룸 팀과 공유할 테스트 결과를 생성할 수 있습니다.
SIS 요구사항 및 예상 동작
Google에서 정의한 테스트는 관심 있는 SIS 파트너가 제품이 Google의 OneRoster 소비 요구사항을 충족하는지 확인하고 사용자가 클래스룸에서 SIS 통합을 사용할 때 발생할 수 있는 오류를 최소화할 수 있는 방법을 제공하기 위해 존재합니다. 테스트에 관한 다음 포인터를 읽어 보세요. GitHub에서 각 테스트에는 포인터에서 참조되는 제목이 있습니다. 포인터는 질문을 명확히 하는 데 도움이 되지만 테스트의 전체 목록은 아닙니다. GitHub에 제공된 모든 테스트를 실행했는지 확인합니다.
| 테스트 | 포인터 |
|---|---|
| 교사: GetAllTeachers | GET /teachers 엔드포인트가 limit 쿼리 매개변수와 함께 호출됩니다. 후속 테스트에서는 이 매개변수를 사용하여 제품이 페이지 크기 10,000을 지원할 수 있는지 확인합니다. |
| 교사: 이메일 필터를 사용하여 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: Create(LineItem: 만들기) | PUT /lineItems/{line_item_sourced_id} 호출 시 성적 기간은 필요하지 않습니다. |
| LineItem: 수정 | 긴 과제 제목 길이가 포함된 경우 API 호출에서 오류가 반환되지 않아야 합니다. 테스트에는 과제 제목 길이가 100자를 초과하는 경우가 포함됩니다. |
| 결과: 수정 | score를 resultValueMax보다 큰 값으로 설정하여 추가 점수를 나타낼 수 있어야 합니다. |
| 결과: 삭제 | DELETE /results/{result_sourced_id} 엔드포인트는 필수 항목입니다. |
| LineItem (선택사항 / 정리): 삭제 및 가져오기 | DELETE /lineItems/{line_item_sourced_id} 엔드포인트는 필요하지 않습니다. 선택사항이며 데이터 정리에 사용됩니다. 후속 GET /classes/{class_sourced_id}/lineItems 엔드포인트도 선택사항이며 광고 항목이 삭제되었는지 테스트합니다. |
Google 클래스룸 팀과 테스트 결과 공유
테스트를 실행하면 각 테스트의 결과가 포함된 전체 보고서가 생성됩니다. 이러한 테스트는 제품이 Google의 OneRoster 1.2 소비 요구사항을 충족하는지 확인하는 데 사용됩니다. 생성된 보고서를 다운로드하거나 스크린샷을 찍어 Google 클래스룸팀과 공유합니다.
지원 받기
궁금한 점이 있으면 classroom-sis-external@google.com으로 이메일을 보내주세요.