이 페이지는 Cloud Translation API를 통해 번역되었습니다.

SIS가 Google 클래스룸 요구사항을 충족하는지 확인하기

SIS를 클래스룸과 통합하려면 제공된 규정 준수 테스트 세트를 실행하여 제품이 클래스룸의 파트너십 요구사항을 충족하는지 확인합니다.

테스트에 액세스하고 실행

GitHub에서 규정 준수 테스트에 액세스할 수 있습니다. 테스트를 실행하려면 다음이 필요합니다.

OAuth 2.0 사용자 인증 정보를 가져오는 토큰 URL
/ims/oneroster/v1p1로 끝나는 OneRoster 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}`를 호출할 때는 평가 카테고리 또는 평가 기간이 필요하지 않습니다.
LineItem: 수정	긴 과제 제목 길이가 포함된 경우 API 호출이 오류를 반환해서는 안 됩니다. 과제 제목의 길이가 100자(영문 기준)를 초과하는 테스트가 포함되어 있습니다.
결과: 수정	`score`를 `resultValueMax`보다 큰 값으로 설정하여 추가 크레딧을 나타낼 수 있어야 합니다.
결과: 삭제	`DELETE /results/{result_sourced_id}` 엔드포인트는 필수 항목입니다.
LineItem (선택사항 / 정리): 삭제 및 가져오기	`DELETE /lineItems/{line_item_sourced_id}` 엔드포인트는 필요하지 않습니다. 이는 선택사항이며 데이터 정리에 사용됩니다. 후속 `GET /classes/{class_sourced_id}/lineItems` 엔드포인트도 선택사항이며 광고 항목이 삭제되었는지 테스트합니다.

채점 카테고리

테스트	포인터
GetAllCategories 또는 GetCategoriesForClass	GetAllCategories 또는 GetCategoriesForClass 중 하나의 `GET /categories` 엔드포인트만 필요합니다. 모든 테스트를 한 번에 실행하는 경우 사용하지 않는 테스트는 주석 처리합니다.
DeleteLineItem (선택사항 / 정리)	DeleteLineItem 테스트는 선택사항이며 데이터 정리에 사용할 수 있습니다.

평가 기간

테스트	포인터
GetGradingPeriodsForTerm	평가 기간 지원은 필터 테스트를 사용하여 GetAllClasses에서 `term_sourced_id`를 검색하여 테스트됩니다. 이 `term_sourced_id`는 GetGradingPeriodsForTerm 테스트에서 `GET terms/{term_sourced_id}/gradingPeriods` 엔드포인트를 호출하여 학기의 평가 기간을 검색하는 데 사용됩니다.

테스트를 실행하면 각 테스트의 결과가 포함된 전체 보고서가 생성됩니다. 이 테스트는 제품이 Google의 OneRoster 1.1 소비 요구사항을 충족하는지 확인하는 데 사용됩니다. 생성된 보고서를 다운로드하거나 스크린샷을 찍습니다. 보고서와 제품의 OneRoster 1.1 인증 링크를 classroom-sis-external@google.com으로 이메일로 보냅니다.

지원 받기

질문이나 우려사항이 있으면 classroom-sis-external@google.com으로 이메일을 보내주세요.

시작하기