SIS를 클래스룸과 통합하려면 제공된 규정 준수 테스트 세트를 실행하여 제품이 클래스룸의 파트너십 요구사항을 충족하는지 확인합니다.
테스트에 액세스하고 실행
GitHub에서 규정 준수 테스트에 액세스할 수 있습니다. 테스트를 실행하려면 다음이 필요합니다.
- OAuth 2.0 사용자 인증 정보를 가져오는 토큰 URL
- 마지막 자리가
/ims/oneroster/v1p1인 One Roster URL - 클라이언트 ID
- 클라이언트 보안 비밀번호
- 교사 이메일 주소
테스트 모음에는 세 가지 섹션이 있습니다.
- 기본 성적 동기화
- 채점 카테고리
- 평가 기간
Google Colab 또는 Jupyter 노트북을 사용하여 테스트를 실행할 수 있습니다. Colab과 Jupyter 노트북 모두에서 모든 테스트를 한 번에 실행할 수 있습니다. 이렇게 하면 테스트 결과를 생성하여 Google 클래스룸팀과 공유할 수 있습니다.
SIS 요구사항 및 예상 동작
Google에서 정의한 테스트는 일관성을 유지하고 사용자가 SIS 통합을 Classroom과 함께 사용할 때 발생할 수 있는 오류를 최소화하기 위해 마련되었습니다. 테스트에 관한 다음 도움말을 읽어보세요. 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 엔드포인트가 호출됩니다. 응답에서 학생 이메일을 반환해야 합니다. |
| LineItem: 만들기 | PUT /lineItems/{line_item_sourced_id}를 호출할 때는 평가 카테고리 또는 평가 기간이 필요하지 않습니다. |
| 광고 항목: 수정 | 긴 과제 제목 길이가 포함된 경우 API 호출이 오류를 반환해서는 안 됩니다. 과제 제목의 길이가 100자(영문 기준)를 초과하는 테스트가 포함되어 있습니다. |
| 결과: 수정 | score를 resultValueMax보다 큰 값으로 설정하여 추가 크레딧을 나타낼 수 있어야 합니다. |
| 결과: 삭제 | DELETE /results/{result_sourced_id} 엔드포인트는 필수 항목입니다. |
| LineItem (선택사항 / 정리): 삭제 및 가져오기 | DELETE /lineItems/{line_item_sourced_id} 엔드포인트는 필요하지 않습니다. 선택사항이며 데이터 정리에 사용됩니다. 후속 GET /classes/{class_sourced_id}/lineItems 엔드포인트도 선택사항이며 광고 항목이 삭제되었는지 테스트합니다. |
채점 카테고리
| 테스트 | 포인터 |
|---|---|
| GetAllCategories 또는 GetCategoriesForClass | GET /categories 엔드포인트는 GetAllCategories 또는 GetCategoriesForClass 중 하나만 필요합니다. 모든 테스트를 한 번에 실행하는 경우 사용하지 않는 테스트는 주석 처리합니다. |
| DeleteLineItem (선택사항 / 정리) | DeleteLineItem 테스트는 선택사항이며 데이터 정리에 사용할 수 있습니다. |
평가 기간
| 테스트 | 포인터 |
|---|---|
| GetGradingPeriodsForTerm | 평가 기간 지원은 필터 테스트를 사용하여 GetAllClasses에서 term_sourced_id를 검색하여 테스트됩니다. 이 term_sourced_id는 GetGradingPeriodsForTerm 테스트에서 GET terms/{term_sourced_id}/gradingPeriods 엔드포인트를 호출하여 학기의 평가 기간을 검색하는 데 사용됩니다. |
Google 클래스룸팀과 테스트 결과 공유
테스트를 실행하면 각 테스트의 결과가 포함된 전체 보고서가 생성됩니다. 이 테스트는 제품이 Google의 OneRoster 1.1 소비 요구사항을 충족하는지 확인하는 데 사용됩니다. 생성된 보고서를 다운로드하거나 스크린샷을 찍습니다. 보고서와 제품의 OneRoster 1.1 인증 링크를 classroom-sis-external@google.com으로 이메일로 보냅니다.
지원 받기
질문이나 우려사항이 있으면 classroom-sis-external@google.com으로 이메일을 보내주세요.