SIS를 클래스룸과 통합하려면 제공된 적합성 테스트 세트를 실행하여 제품이 클래스룸의 파트너십 요구사항을 충족하는지 확인하세요.
테스트 액세스 및 실행
GitHub에서 적합성 테스트에 액세스할 수 있습니다. 테스트를 실행하려면 다음이 필요합니다.
- OAuth 2.0 사용자 인증 정보를 가져올 토큰 URL
/ims/oneroster/v1p1(으)로 끝나는 출석부 URL 1개- 클라이언트 ID
- 클라이언트 보안 비밀번호
- 교사 이메일 주소
테스트 모음에는 다음과 같은 세 개의 섹션이 있습니다.
- 기본 성적 동기화
- 성적 카테고리
- 평가 기간
Google Colab 또는 Jupyter 노트북을 사용하여 테스트를 실행할 수 있습니다. Colab과 Jupyter 노트북 모두에서 모든 테스트를 한 번에 실행할 수 있습니다. 이렇게 하면 Google 클래스룸팀과 공유할 테스트 결과를 생성하는 데 도움이 됩니다.
SIS 요구사항 및 예상 동작
Google에서 정의한 테스트는 일관성을 유지하고 클래스룸과 SIS 통합을 활용할 때 발생할 수 있는 오류를 최소화하기 위해 존재합니다. 테스트에서 다음 포인터를 읽어보세요. GitHub에서 각 테스트는 @title로 표시됩니다. 이러한 제목은 포인터에서 참조됩니다.
기본 성적 동기화 섹션에 대해 다음 사항을 참고하세요.
GetAllTeachers테스트에서GET /teachers엔드포인트는limit=쿼리 매개변수와 함께 호출됩니다. 후속 테스트에서 이 매개변수는 제품이 10,000 크기의 페이지 크기를 지원할 수 있는지 확인하는 데 사용됩니다.GetAllTeachers with email filter테스트에서GET /teachers엔드포인트는 교사 이메일 주소를 기반으로 필터링하는 데 사용되는filter=쿼리 매개변수와 함께 호출됩니다. 테스트를 실행할 때 교사 이메일 주소를 지정해야 합니다.GetClassesForTeacher테스트에서/teachers/{teacher_sourced_id}/classes엔드포인트는 활성 클래스를 기반으로 필터링하는 데 사용되는filter=쿼리 매개변수와 함께 호출됩니다.GetStudentsForClass테스트에서GET /classes/{class_sourced_id}/students?limit=10000엔드포인트가 호출됩니다. 응답에 학생 이메일이 반환되어야 합니다.PutLineItem Create테스트에서는PUT /lineItems/{line_item_sourced_id}를 호출할 때 성적 카테고리 또는 평가 기간이 필요하지 않습니다.PutLineItem Edit테스트에서 긴 과제 제목 길이가 포함된 경우 API 호출은 오류를 반환해서는 안 됩니다. 테스트에는 100자(영문 기준) 이상의 과제 제목 길이가 포함됩니다.PutResult Edit테스트에서score를resultValueMax보다 큰 값으로 설정하여 추가 크레딧을 나타낼 수 있어야 합니다.DELETE /results/{result_sourced_id}엔드포인트는 필수이며DeleteResult테스트에서 테스트됩니다.DELETE /lineItems/{line_item_sourced_id}엔드포인트는 필요하지 않습니다. 이는 선택사항이며 데이터 정리에 사용됩니다.
성적 카테고리 및 평가 기간 섹션에 관한 다음 사항을 참고하세요.
GET /categories엔드포인트는 하나만 필요합니다. 모든 적합성 테스트를 한 번에 실행하는 경우 사용하지 않는 테스트를 주석 처리합니다./categories?limit=10000/classes/{class_sourced_id}/categories?limit=10000
- 평가 기간 지원은
GetAllClasses w/ filter테스트에서term_sourced_id를 검색하여 테스트합니다. 이term_sourced_id은GetGradingPeriodsForTerm테스트에서GET terms/{term_sourced_id}/gradingPeriods?limit=10000엔드포인트를 호출하여 용어의 평가 기간을 검색하는 데 사용됩니다.
Google 클래스룸팀과 테스트 결과 공유
테스트를 실행하면 각 테스트 결과가 포함된 전체 보고서가 생성됩니다. 이러한 테스트는 제품이 Google의 OneRoster 1.1 소비 요구사항을 충족하는지 확인하는 데 사용됩니다. 생성된 보고서를 다운로드하거나 스크린샷을 찍습니다. 보고서 및 제품의 OneRoster 1.1 인증 링크를 classroom-sis-external@google.com으로 보냅니다.
지원 받기
질문이나 우려사항이 있는 경우 classroom-sis-external@google.com으로 이메일을 보내주세요.