버전 1.0, 2024년 4월 30일.
이 페이지의 기준은 모든 클래스룸 부가기능에 적용됩니다. 부가기능은 Google Workspace Marketplace에 등록하기 위한 승인과 'Works with Classroom'의 부가기능 등록을 위한 모든 관련 필수 항목을 충족해야 합니다.
이 문서의 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY' 및 'OPTIONAL'은 RFC 2119에 설명된 대로 해석되어야 합니다.
요건
| ID | 유형 | ||
|---|---|---|---|
| 1.0 | 최종 사용자 라이선스 (해당하는 경우) | ||
| 1.1 | 사용자에게 라이선스가 없는 경우 사용자 친화적인 메시지를 표시해야 합니다(MUST). 메시지는 부가기능을 사용할 수 없는 이유를 명시하고 사용자가 상황을 해결할 수 있는 조치를 제안해야 합니다(MUST). | REQUIRED | |
| 1.3 | 부가기능의 Google Workspace Marketplace 등록정보에 부가기능을 사용하는 데 필요할 수 있는 라이선스 요구사항에 관한 세부정보가 명시되어야 합니다(MUST). 부가기능에 유료 등급이 포함된 경우 Marketplace 등록정보는 가격 또는 영업 담당자에게 문의하는 방법에 관한 추가 정보를 제공하는 웹페이지 링크를 제공해야 합니다(MUST). | REQUIRED | |
| 2.0 | 최종 사용자 로그인 | ||
| 2.1 | 교사 사용자는 Google SSO를 사용하여 부가기능에 로그인해야 합니다. 학생 사용자에게 부가기능에 로그인하라는 메시지가 표시되면 Google SSO를 사용하여 로그인해야 합니다. |
REQUIRED | |
| 2.2 | 부가기능은 로그인 메시지를 표시하지 않고 이후 방문 시 사용자가 자동으로 로그인하도록 하려면 Google SSO를 사용해야 합니다(MUST). 로그인 힌트가 현재 로그인한 사용자와의 매칭을 생성하지 않으면 부가기능은 사용자에게 로그인 버튼을 표시하고 로그인 힌트를 인증 라이브러리에 전달하여 잘못된 계정을 필터링해야 합니다(MUST). |
REQUIRED | |
| 2.7 | 클래스룸 사용자가 아직 부가기능에 로그인하지 않은 경우(로그인 힌트를 통해 확인됨) 부가기능은 명시적인 사용자 작업을 위해 'Google 계정으로 로그인' 버튼을 표시하여 로그인 프로세스를 트리거해야 합니다(MUST). 참고: 이는 Google 브랜드 가이드라인을 충족하는 데 필요하며 팝업 차단기를 방지하는 데도 도움이 됩니다. |
REQUIRED | |
| 2.8 | 부가기능은 현재 로그인한 사용자가 누구인지 표시해야 합니다(SHOULD). | 추천 | |
| 3.0 | 일반 | ||
| 3.1 | 부가기능은 일반 Google Workspace Marketplace 승인 가이드라인을 준수해야 합니다(MUST). | REQUIRED | |
| 3.2 | iframe 여정에서 새 탭 또는 창으로 작업이 실행되는 경우 클래스룸으로 돌아갈 수 있는 사용자 친화적인 메시지를 제공해야 합니다(MUST). | REQUIRED | |
| 3.3 | 사용자는 부가기능 워크플로를 사용해서만 여정을 완료해야 하며, 과정 워크플로로 전환하거나 클래스룸 공유 버튼을 사용해서는 안 됩니다. | REQUIRED | |
| 3.4 | 현지화 선택: 언어는 사용 가능한 경우 브라우저에서 설정한 로컬 환경설정을 기반으로 해야 합니다(SHOULD). | 추천 | |
| 3.5 | 부가기능이 maxPoints를 정의하는 경우 학생이 저장된 교사 사용자 인증 정보를 사용하여 제출물을 완료하거나(권장) 교사가 학생 과제물 검토 iframe에서 제출물을 여는 경우 pointsEarned를 설정해야 합니다(MUST). |
REQUIRED | |
| 3.9 | 부가기능은 접근성에 관한 WCAG 2.1 수준 AA 가이드라인을 준수해야 합니다(SHOULD). 부가기능 개발자는 제출 시점에 이러한 요구사항이 충족되며 부가기능이 향후 부가기능 변경사항을 계속해서 준수한다고 직접 보고합니다. | 추천 | |
| 3.10 | 사용자가 경험한 모든 오류는 인간이 읽을 수 있어야 합니다(MUST). | REQUIRED | |
| 3.11 | 복사된 과제 또는 복사된 강의에서 studentViewUri, teacherViewUri 또는 studentWorkViewUri가 실행되는 경우 부가기능은 iframe에 오류 페이지를 표시하면 안 됩니다(MUST NOT). |
REQUIRED | |
| 3.12 | 복사된 과제 또는 복사된 강의에서 studentViewUri, teacherViewUri 또는 studentWorkViewUri가 실행되는 경우 부가기능은 학생이 완료할 수 있도록 새 첨부파일을 표시해야 하며(SHOULD) 이전 과제 또는 과정의 학생의 응답을 iframe에 표시하면 안 됩니다(SHOULD NOT). |
추천 | |
| 4.0 | 첨부파일 검색 | ||
| 4.1 | 학생 제출이 필요한 첨부파일인 경우 콘텐츠 유형 첨부파일이 아닌 활동 유형으로 처리되도록 첨부파일에 studentWorkReviewUri를 포함해야 합니다(MUST). |
REQUIRED | |
| 4.2 | 첨부파일 검색 iframe은 다음 중 하나 이상을 제공하는 사용자 인터페이스를 제공해야 합니다(MUST).
|
REQUIRED | |
| 4.3 | 교사는 교사가 사용할 수 있는 모든 콘텐츠/활동을 찾고 액세스할 수 있어야 합니다(SHOULD). | 추천 | |
| 4.4 | 교사는 과제에 첨부하기로 약속하기 전에 콘텐츠/활동을 미리 볼 수 있어야 합니다(MUST). | REQUIRED | |
| 4.5 | 첨부되기 전에 교사가 콘텐츠/활동을 만들어야 하는 경우 해당 작업은 iframe에서 완료해야 합니다(SHOULD). | 추천 | |
| 5.0 | 학생 뷰 | ||
| 5.1 | studentViewUri가 실행되면 부가기능이 작업을 완료하기 위해 사용자를 iframe 밖으로 팝하면 안 됩니다(SHOULD NOT).부가기능이 사용자를 iframe 밖으로 팝하는 경우 학생들이 클래스룸으로 돌아가도록 하는 메시지나 기타 표시가 있어야 합니다(MUST). |
추천 | |
| 5.2 | 부가기능 활동이 iframe에서 튀어나오면 iframe에 작업에 관한 미리보기가 있어야 합니다(MUST). | REQUIRED | |
| 5.3 | 학생이 과제를 완료로 표시하기 위해 조치를 취해야 하는 활동인 경우 클래스룸 제출 버튼과 혼동을 피하기 위해 버튼에 '제출' 라벨을 지정하면 안 됩니다(MUST NOT). | REQUIRED | |
| 6.0 | 교사 뷰 | ||
| 6.1 | 교사는 학생이 과제를 수행할 때 표시되는 내용을 볼 수 있어야 합니다(SHOULD). | 추천 | |
| 7.0 | 학생 과제물 검토 | ||
| 7.1 | studentWorkReviewUri가 실행되면 부가기능이 교사 검토를 위해 iframe 내에서 학생의 과제물을 렌더링해야 합니다(MUST). 보충 자료는 iframe 외부로 연결될 수 있습니다. |
REQUIRED | |
| 7.2 | 부가기능이 studentWorkReviewUri 뷰에서 학생 간 탐색을 사용 설정하면 안 됩니다(MUST NOT). 학생 간 이동은 클래스룸 UI에서만 이뤄져야 합니다. |
REQUIRED | |
| 8.0 | 클래스룸 모바일 지원 | ||
| 8.1 | 클래스룸 모바일 앱이 teacherViewUri, studentViewUri 또는 studentWorkReviewUri를 실행하면 URL이 파트너의 모바일 네이티브 앱 또는 파트너의 모바일 웹 앱을 열거나 어떤 경우든 올바른 뷰로 딥 링크를 연결해야 합니다(MUST). 지원되지 않는 기기인 경우 지원되지 않는 기기임을 알리는 메시지를 사용자에게 표시해야 하며 이상적으로는 어떤 기기가 지원되는지를 알려야 합니다(MUST). |
REQUIRED | |
| 8.2 | 학생 과제물은 휴대기기에서 완료할 수 있어야 합니다(SHOULD). | 추천 | |
| 9.0 | 추가 기능 | ||
| 9.1 | 교사가 콘텐츠 링크를 링크 첨부파일로 붙여넣을 수 있는 경우 링크를 부가기능 첨부파일로 업그레이드해야 합니다(SHOULD). | 추천 | |
| 9.2 | CourseWork 통합을 사용하여 클래스룸 외부에서 과제를 만드는 경우 부가기능과 호환되는 모든 링크에 대해 기본적으로 부가기능 첨부파일을 만들어야 합니다(SHOULD). | 추천 | |
변경 로그
| 버전 1.0 | 업데이트: 2024년 4월 30일 |
| 1.1 | 1.1과 1.2가 단일 요구사항으로 결합되었습니다. |
| 2.1 | 2.1과 2.5가 단일 요구사항으로 결합되었습니다. |
| 2.2 | 2.2, 2.3, 2.4가 단일 요구사항으로 결합되었습니다. |
| 3.5 | 3.5, 3.6, 3.7이 단일 요구사항으로 결합되었습니다. |
| 3.10 | 부가기능이 알아볼 수 없거나 복구할 수 없는 상태로 전환되지 않아야 한다는 요구사항이 추가되었습니다. |
| 3.11, 3.12 | 5.5, 5.6, 6.3, 6.4, 7.5, 7.6이 새로운 요구사항 2개로 결합되었습니다. |
| 4.2 | 허용되는 첨부파일 검색 환경에 대한 설명을 확대했습니다. |
| 4.3 | 이전 4.2로 번호가 변경되었습니다. 또한 REQUIRED에서 RECOMMENDED로 변경되었습니다. |
| 4.4 | 이전 4.3으로 번호가 변경되었습니다. |
| 4.5 | 이전 4.4로 번호가 변경되었습니다. |
| 5.2 | 이전 5.3으로 번호가 변경되었습니다. |
| 5.3 | 이전 5.2로 번호가 변경되었습니다. |
| 9.1 | 붙여넣은 링크를 첨부파일로 업그레이드하라는 권장사항이 추가되었습니다. |
| 9.2 | 프로그래매틱 방식으로 CourseWork 할당을 만들 때 기본적으로 부가기능 첨부파일을 생성하라는 추천이 추가되었습니다. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | 삭제되었습니다. |
| 버전 0.3 | 업데이트: 2022년 11월 22일 |
| 2.3 | 로그인 힌트 안내가 수정되었습니다. |
| 2.4 | hd 구현이 필요한 시나리오가 통합되었습니다. |
| 3.2 | '경로 제공'으로 변경되었습니다. |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | studentViewUri, teacherViewUri, studentWorkReviewUri에 대한 필수 및 권장 안내를 추가했습니다. |
| 버전 0.2 | 업데이트: 2021년 10월 29일 |
| 1.3 | 의도가 더 명확하도록 텍스트를 수정했습니다. |
| 3.1 | '부가기능은 웹사이트에 있는 일반적인 GWM 승인 가이드라인을 준수해야 합니다(MUST).'라는 내용을 추가했습니다. |
| 3.9 | WCAG에서 '필수'를 'RE'로 변경했습니다. |
| 5.1 | REQUIRED를 RECOMMENDED(으)로 변경했습니다. |
| 5.3 | '부가기능이 iframe에서 팝업되는 경우 iframe에 작업에 관한 미리보기가 있어야 합니다(MUST).'라는 내용을 추가했습니다. |
| 5.4 | '부가기능이 iframe에서 튀어나오면 학생들이 클래스룸으로 돌아가도록 하는 메시지가 표시되어야 합니다(SHOULD).'가 추가되었습니다. |
| 8.1 | '지원되지 않는 기기인 경우 사용자에게 기기가 지원되지 않는 기기임을 알리는 메시지를 표시해야 하며 이상적으로는 어떤 기기가 지원되는지 알리는 메시지를 표시해야 합니다(MUST).' |
| 8.2 | 모바일 학생 과제물이 '필수'에서 'RECOMM'으로 변경됨 |
| 버전 0.1 | 업데이트: 2021년 9월 22일 |
| 첫 출시입니다. |