관심 있는 SIS 파트너는 GitHub의 규정 준수 테스트를 사용하여 제품이 Google 클래스룸의 OneRoster 소비 요구사항을 충족하는지 확인할 수 있습니다.
테스트에 액세스하고 실행
테스트를 실행하려면 다음이 필요합니다.
- 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.1 소비 요구사항을 충족하는지 확인하는 데 사용됩니다. 생성된 보고서를 다운로드하거나 스크린샷을 찍어 Google 클래스룸팀과 공유합니다.
지원 받기
질문이나 우려사항이 있으면 classroom-sis-external@google.com으로 이메일을 보내주세요.