Google 클래스룸은 여러 OneRoster 준수 학생 정보 시스템 (SIS)의 성적 기록 동기화 및 출석부 가져오기를 지원합니다. Google은 Google에서 지정한 OneRoster 요구사항을 충족하는 SIS 플랫폼과 협력합니다.
클래스룸과 파트너 관계를 맺으면 관리자가 클래스룸 수업을 SIS에 연결할 수 있습니다.
그림 1. 학생 정보 시스템 (SIS)이 클래스룸과 파트너 관계를 맺은 경우 관리자는 드롭다운에서 SIS를 선택할 수 있습니다.
SIS 파트너 개발 여정
클래스룸과의 파트너십에 관심이 있는 경우 classroom-sis-external@google.com으로 문의하여 자세히 알아보세요.
클래스룸팀은 관심 있는 SIS 파트너가 Google 요구사항을 숙지하는 데 사용할 수 있는 규정 준수 테스트 모음을 만들었습니다. 제품이 Google의 요구사항을 얼마나 충족하는지 확인하기 위해 먼저 Classroom팀에 문의하기 전에 규정 준수 테스트를 실행할 수 있습니다.
개발자 데모 도메인 가져오기
통합을 빌드하고 검증하려면 실시간 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: 만들기 | 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으로 이메일을 보내주세요.