SIS를 클래스룸과 통합하려면 제품을 확인하세요. 클래스룸의 파트너십 요구사항을 충족하도록 제공되는 적합성 테스트 세트
테스트 액세스 및 실행
GitHub에서 적합성 테스트에 액세스할 수 있습니다. 테스트를 실행하려면 다음이 필요합니다.
- OAuth 2.0 사용자 인증 정보를 가져오는 토큰 URL
- 마지막 자리가
/ims/oneroster/v1p1
인 One Roster URL - 클라이언트 ID
- 클라이언트 보안 비밀번호
- 교사 이메일 주소
테스트 모음에는 세 가지 섹션이 있습니다.
- 기본 성적 동기화
- 평가 카테고리
- 평가 기간
Google Colab 또는 Jupyter 노트북을 사용하여 테스트를 실행할 수 있습니다. Colab 모두 Jupyter 노트북을 사용하면 모든 테스트를 한 번에 실행할 수 있습니다. 이렇게 하면 테스트 결과를 Google 클래스룸팀과 공유할 수 있습니다.
SIS 요구사항 및 예상 동작
Google에서 정의한 테스트는 일관성을 유지하고 사용자가 SIS 통합을 활용할 때 발생할 수 있는 오류 클래스룸. 테스트에서 다음 포인터를 자세히 읽어보세요. 포함 GitHub에 있는 각 테스트에는 포인터에서 참조되는 제목이 있습니다. 유의사항 포인터가 질문을 명확히 하는 데 도움이 될 수는 있지만 전체 목록이 아닙니다. 매우 유용합니다. GitHub에서 제공한 모든 테스트를 실행했는지 확인합니다.
기본 성적 동기화
테스트 | 포인터 |
---|---|
교사: GetAllTeachers | GET /teachers 엔드포인트는 limit 쿼리 매개변수와 함께 호출됩니다. 후속 테스트에서 이 매개변수는 제품이 10,000의 페이지 크기를 지원할 수 있는지 확인하는 데 사용됩니다. |
교사: 이메일 필터를 사용한 GetAllTeachers | GET /teachers 엔드포인트는 교사 이메일 주소를 기준으로 필터링하는 데 사용되는 filter 쿼리 매개변수와 함께 호출됩니다. 시험의 사용자 인증 정보 섹션에 입력한 교사 이메일 주소를 사용합니다. |
클래스: GetClassesForTeacher | /teachers/{teacher_sourced_id}/classes 엔드포인트는 활성 클래스를 기준으로 필터링하는 데 사용되는 filter 쿼리 매개변수와 함께 호출됩니다. |
학생: GetStudentForClass | GET /classes/{class_sourced_id}/students 엔드포인트가 호출됩니다. 응답 시 학생 이메일이 반환되어야 합니다. |
광고 항목: 만들기 | PUT /lineItems/{line_item_sourced_id} 를 호출할 때는 평가 카테고리 또는 평가 기간이 필요하지 않습니다. |
광고 항목: 수정 | 긴 과제 제목 길이가 포함된 경우 API 호출에서 오류가 반환되어서는 안 됩니다. 테스트에는 100자 이상의 과제 제목 길이가 포함됩니다. |
결과: 수정 | 추가 기여도를 나타내기 위해 score 를 resultValueMax 보다 큰 값으로 설정할 수 있습니다. |
결과: 삭제 | DELETE /results/{result_sourced_id} 엔드포인트는 필수 항목입니다. |
광고 항목 (선택사항 / 정리): 삭제 및 가져오기 | 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으로 이메일을 보내거나 있습니다