클래스룸에서 수업 활동 보기, 만들기, 수정하기
Classroom API의 CourseWork 엔드포인트로 무엇을 빌드할 수 있나요?
개발자는 엔드포인트를 사용하여 수업의 과제물을 보고 관리할 수 있습니다. 구체적으로 다음 작업을 모두 할 수 있습니다.
- 사용자의 과제 및 질문 (총칭하여
CourseWork) 보기 CourseWork만들기, 수정, 삭제CourseWork에 자료 (Drive 파일, YouTube 동영상, 링크) 첨부- 학생의 제출물 상태 변경 (예: 제출, 반환, 회수)
- 과제 제출물의 성적 설정하기
- 학생 제출물에 자료 (Drive 파일, YouTube 동영상, 링크) 첨부
CourseWork의 샘플 사용 사례는 다음과 같습니다.
- 성적부, SIS 또는 보고 시스템에서 클래스룸의 과제와 성적을 애플리케이션과 동기화하여 수동 데이터 전송을 없앨 수 있습니다.
- 학습 애플리케이션은 수업 스트림에 표시되는 새 과제를 만들 수 있습니다. 학생이 과제를 완료하면 애플리케이션에서 과제를 제출하고, 성적을 설정하고, 학생 과제를 첨부하고, 적절한 Drive 폴더에 과제를 저장할 수 있습니다.
- 교사 사용자는 웹사이트 또는 애플리케이션에서 부가기능 첨부파일이 포함된 과제를 만들 수 있습니다.
- 학생 사용자는 부가기능 첨부파일이 있는 과제를 제출할 수 있습니다.
과제를 만들거나 수정하려면 애플리케이션에 어떤 권한이 필요한가요?
일반적으로 애플리케이션은 자신이 만든 작업만 수정할 수 있습니다. 즉, 모든 과제 변형 API 요청은 과제 생성 시 저장된 것과 동일한 Google Cloud 프로젝트 ID를 사용해야 합니다.
Google 클래스룸 부가기능에는 이 규칙이 적용되지 않습니다. Cloud 프로젝트는 하나 이상의 부가기능 첨부파일이 있는 공지사항, 과제 또는 자료에 액세스하거나 이를 수정할 수 있습니다. Cloud 프로젝트는 부가기능 첨부파일이 하나 이상 있는 과제를 제출, 회수 또는 반환할 수도 있습니다.
API 요청에는 올바른 사용자 범위도 필요합니다. 교사는 과제를 보고, 과제를 만들고, 과제 제출물에 링크를 첨부하고, 제출물 성적을 설정할 수 있습니다. 학생은 과제를 확인하고, 과제 기록에 링크를 첨부하고, 제출물을 제출 및 회수할 수 있습니다. 도메인 관리자는 CourseWork를 볼 수 있지만 쓰기 권한은 없습니다.
내 신청서에서 과제 또는 제출물에 어떤 유형의 항목을 첨부할 수 있나요?
이 API는 Drive 파일, YouTube 동영상, 링크를 첨부하는 기능을 지원합니다. 기본 Google 양식은 아직 첨부할 수 없습니다.
최종 사용자는 클래스룸의 과제가 내 애플리케이션에서 생성되었다는 것을 알 수 있나요?
예. 클래스룸 UI는 과제를 만든 Google Cloud 프로젝트의 제품 이름을 사용하여 외부에서 만든 과제를 식별합니다. 사용자는 외부에서 생성된 작업을 원치 않는 작업으로 신고할 수 있으며, 사용자가 애플리케이션에 발급한 사용자 인증 정보를 취소하여 작업을 만든 애플리케이션의 연결을 해제할 수 있습니다.
클래스룸 공유 버튼 및 기타 통합
이미 클래스룸 공유 버튼과 통합했습니다. 공유 버튼을 사용하여 만든 과제를 수정할 수 있나요?
아직이요. 과제를 수정하려면 요청에서 과제를 만든 것과 동일한 Google Cloud 프로젝트를 사용해야 합니다.
API에서 질문에 답변할 수 있나요?
아직이요. 질문을 만들고 수정할 수 있습니다.
클래스룸 부가기능
프로젝트 구성
개발 중에 사용한 비공개 Google Cloud 프로젝트를 프로덕션에서 사용할 수 있는 공개 프로젝트로 변환할 수 있나요?
비공개 Google Cloud 프로젝트를 공개 프로젝트로 변환할 수는 없습니다. 개발용과 프로덕션용 하나씩 별도의 프로젝트 두 개가 필요합니다.
하나의 Google Cloud 프로젝트에 Google Workspace Marketplace 등록정보가 두 개 있을 수 있나요?
아니요. 단일 Google Cloud 프로젝트에 Google Workspace Marketplace 등록정보를 두 개 만들 수 없습니다.
하지만 부가기능을 번들로 묶을 수는 있습니다. 이렇게 하면 단일 Google Workspace Marketplace 등록정보로 여러 부가기능을 나타낼 수 있습니다. 이러한 목록에서 설치하면 번들의 모든 부가기능이 한 번에 설치됩니다. 사용자는 승인 시 번들 부가기능에 필요한 모든 범위에 동의해야 합니다.
다른 Google Cloud 프로젝트의 OAuth 클라이언트를 클래스룸 부가기능용 Google Cloud 프로젝트에서 재사용할 수 있나요?
아니요. 클래스룸 부가기능 Google Cloud 프로젝트 이외의 Google Cloud 프로젝트의 OAuth 클라이언트는 작동하지 않습니다. 다른 Google Cloud 프로젝트에서 생성된 액세스 토큰은 Classroom API에서 거부됩니다. 부가기능 프로젝트에 대해 별도의 OAuth 클라이언트를 만들어야 합니다.
사용자 환경
로고가 작은 정사각형에 잘 맞지 않습니다. iframe 제목 표시줄의 로고에는 어떤 크기 옵션이 있나요?
iframe 제목 표시는 32x32 정사각형 로고만 지원하도록 설계되었습니다. 이는 회사가 웹사이트에 사용하는 favicon 모양과 일치하도록 선택되었으며, 브랜드 일관성을 위해 이 공간에 동일한 로고를 사용하는 것이 Google의 가이드입니다.
도메인
동일한 도메인의 모든 교사와 학생이 설치된 부가기능에 액세스할 수 있나요?
학교 관리자는 설치된 부가기능을 볼 수 있는 교사를 관리할 수 있습니다. 클래스룸 부가기능은 Teaching & Learning 또는 Education Plus 라이선스가 있는 사용자만 사용할 수 있습니다.
도메인 관리자는 부가기능과 어떻게 상호작용하나요?
도메인 관리자 (관리자)가 부가기능을 사용할 수 있는 사용자를 관리합니다. 관리자 설치 옵션을 사용하여 전체 도메인에 부가기능을 설치할 수 있습니다. 부가기능을 개별적으로 설치할 수 있는 경우 대부분의 관리자는 부가기능 허용 목록을 유지합니다. 교사는 이 목록에 있는 부가기능을 직접 설치할 수 있습니다. 관리자가 테스트 목적으로 부가기능을 개별적으로 설치할 수도 있습니다.
관리자는 부가기능과 관련된 사용 통계에도 관심을 가질 수 있습니다. 제품에서 지원하는 경우 자체 사이트의 관리자 뷰에 부가기능 사용 통계를 제공해 보세요.
API
파트너 페이지가 iframe 또는 팝아웃 탭 내에 로드되는지 확인하는 신뢰할 수 있는 방법은 무엇인가요?
현재 두 가지를 구분할 수 있는 방법은 없습니다.
할당 가능한 어떤 작업 항목에 학생 과제물 검토 iframe이 표시되나요?
학생 과제물 검토 iframe은 활동 유형 첨부파일에만 제공됩니다.
courses.courseWork.getAddOnContext 메서드를 호출하여 게시물 유형이 학생 과제물을 지원하는지 확인합니다. supportsStudentWork 필드는 활동인 게시물 유형에 대해서만 true일 수 있습니다.
부가기능 첨부파일이 연결된 스트림 항목에 액세스할 수 있나요?
예. 부가기능 첨부파일 중 하나 이상이 포함된 Announcement, CourseWork 또는 CourseWorkMaterial를 get 또는 patch할 수 있습니다.
CourseWork StudentSubmission를 reclaim, return 또는 turnIn할 수 있습니다.
싱글 사인온(SSO)
Clever 배지 또는 Classlink를 사용하여 Chromebook에 로그인하는 학생이 Google 로그인을 사용할 수 있나요?
예, Google 로그인을 계속 사용할 수 있습니다.
모든 학생에게 Gmail 액세스 권한이 없더라도 올바른 형식의 이메일 주소가 있나요?
Gmail에 액세스할 수 있는지와 관계없이 모든 Google Workspace for Education 사용자에게는 Google ID가 있습니다. ID는 이메일 주소로 표현됩니다. 특정 Google 서비스 (Gmail 포함)의 ID 및 액세스 권한은 구분됩니다. 따라서 Gmail이 사용 중지되더라도 학생 사용자는 이메일 주소로 로그인할 수 있습니다.
학생이 로그인할 수 있도록 학교 관리자가 앱을 사전 승인해야 하나요?
부가기능을 설치하려면 도메인 관리자가 부가기능을 허용 목록에 추가해야 합니다. 원하는 경우 도메인 관리자는 도메인 또는 조직 단위 내 모든 사용자를 위해 부가기능을 설치할 수 있습니다.
의견 및 일반 질문
기능 요청을 제출하거나 문제를 요청하려면 어떻게 해야 하나요?
공개 Issue Tracker에서 기능 요청을 제출, 확인, 투표할 수 있습니다.
Classroom API에서 새로운 기능을 사용할 수 있는 시점을 어떻게 알 수 있나요?
API 업데이트는 출시 노트 페이지, 개발자 포럼, 공개 Issue Tracker에 게시됩니다.
Classroom API를 사용하고 있습니다. 기술 관련 질문은 어떻게 해야 하나요?
google-classroom 태그를 사용하여 Stack Overflow에 질문을 게시합니다.