자주 묻는 질문(FAQ)

클래스룸에서 수업 활동 보기, 만들기, 수정

Classroom API의 CourseWork 엔드포인트로 무엇을 빌드할 수 있나요?

엔드포인트를 사용하면 개발자가 수업의 작업을 보고 관리할 수 있습니다. 구체적으로 다음 작업을 모두 수행할 수 있습니다.

  • 사용자의 과제와 질문 (총칭하여 CourseWork라고 함)을 확인합니다.
  • CourseWork 생성, 수정, 삭제
  • CourseWork에 자료 (Drive 파일, YouTube 동영상, 링크)를 첨부합니다.
  • 학생 제출물의 상태를 변경합니다 (예: 제출, 반환, 회수).
  • 과제 제출의 성적을 설정합니다.
  • 학생 제출물에 자료 (Drive 파일, YouTube 동영상, 링크)를 첨부합니다.

CourseWork의 몇 가지 사용 사례는 다음과 같습니다.

  • 성적표, SIS 또는 보고 시스템은 클래스룸의 과제와 성적을 애플리케이션과 동기화하여 수동 데이터 전송을 없앨 수 있습니다.
  • 학습 애플리케이션은 수업 스트림에 표시되는 새 과제를 만들 수 있습니다. 학생이 과제를 완료하면 애플리케이션에서 과제를 제출하고, 성적을 설정하고, 학생 과제를 첨부하고, 적절한 Drive 폴더에 과제를 저장할 수 있습니다.
  • 교사 사용자는 웹사이트 또는 애플리케이션에서 부가기능 첨부파일을 사용하여 과제를 만들 수 있습니다.
  • 학생 사용자는 부가기능 첨부파일이 있는 과제를 제출할 수 있습니다.

애플리케이션에서 과제를 만들거나 수정하려면 어떤 권한이 필요한가요?

일반적으로 애플리케이션은 자신이 만든 작업만 수정할 수 있습니다. 즉, CourseWork를 수정하는 API 요청은 CourseWork를 만드는 데 사용된 것과 동일한 Google Cloud 프로젝트 ID를 사용해야 합니다.

Google 클래스룸 부가기능에는 이 규칙의 예외가 적용됩니다. Cloud 프로젝트는 하나 이상의 부가기능 첨부파일이 있는 공지사항, 과제 또는 자료에 액세스하거나 이를 수정할 수 있습니다. Cloud 프로젝트는 하나 이상의 부가기능 첨부파일이 있는 과제를 제출하거나, 회수하거나, 반환할 수도 있습니다.

API 요청에는 올바른 사용자 범위도 필요합니다. 교사는 과제를 확인하고, 과제를 만들고, 과제 제출물에 링크를 첨부하고, 제출 성적을 설정할 수 있습니다. 학생은 과제를 확인하고, 과제 기록에 링크를 첨부하고, 제출물을 제출하고 회수할 수 있습니다. 도메인 관리자는 CourseWork를 볼 수 있지만 쓰기 권한은 없습니다.

애플리케이션에서 과제 또는 제출에 어떤 유형의 항목을 첨부할 수 있나요?

API는 Drive 파일, YouTube 동영상, 링크 첨부를 지원합니다. 기본 Google Forms 첨부는 아직 지원되지 않습니다.

최종 사용자가 클래스룸의 과제가 내 애플리케이션에 의해 생성되었음을 알 수 있나요?

예. Classroom 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 클라이언트를 Classroom 부가기능용 Google Cloud 프로젝트와 함께 재사용할 수 있나요?

아니요. Classroom 부가기능 Google Cloud 프로젝트가 아닌 다른 Google Cloud 프로젝트의 OAuth 클라이언트는 작동하지 않습니다. 다른 Google Cloud 프로젝트에서 생성된 액세스 토큰은 Classroom API에서 거부됩니다. 부가기능 프로젝트에 별도의 OAuth 클라이언트를 만들어야 합니다.

사용자 환경

로고가 작은 정사각형에 잘 맞지 않습니다. 클래스룸 부가기능 iframe 제목 표시줄의 로고 크기 옵션은 무엇인가요?

iframe 제목 표시줄은 32x32 정사각형 로고만 지원하도록 설계되었습니다. 이 선택은 회사가 웹사이트에서 사용하는 파비콘 모양과 일치하도록 이루어졌으며, 브랜드 일관성을 위해 이 공간에 동일한 로고를 사용하는 것이 좋습니다.

도메인

동일한 도메인의 모든 교사와 학생이 설치된 부가기능에 액세스할 수 있나요?

도메인 관리자는 설치된 부가기능을 볼 수 있는 교사를 관리할 수 있습니다. 클래스룸 부가기능은 Teaching & Learning 또는 Education Plus 라이선스가 있는 사용자만 사용할 수 있습니다.

도메인 관리자는 부가기능과 어떻게 상호작용하나요?

도메인 관리자는 부가기능을 사용할 수 있는 사용자를 관리합니다. 관리자는 관리자 설치 옵션을 사용하여 전체 도메인에 부가기능을 설치할 수 있습니다. 부가기능을 개별적으로 설치할 수 있는 경우 대부분의 관리자가 부가기능 허용 목록을 유지합니다. 이 목록에 있는 교사는 부가기능을 직접 설치할 수 있습니다. 관리자는 테스트 목적으로 부가기능을 개별적으로 설치할 수도 있습니다.

관리자는 부가기능에 관한 사용 통계에도 관심이 있을 수 있습니다. 제품에서 지원하는 경우 자체 사이트의 관리자 뷰에 부가기능 사용 통계를 제공하는 것이 좋습니다.

API

부가기능 콘텐츠가 iframe 또는 새 탭 내에 로드되었는지 확인하는 안정적인 방법은 무엇인가요?

현재 두 가지를 구분할 수 있는 방법은 없습니다.

학생 과제 검토 iframe이 표시되는 할당 가능한 작업 항목은 무엇인가요?

학생 과제 검토 iframe은 활동 유형 첨부파일에만 제공됩니다. courses.courseWork.getAddOnContext 메서드를 호출하여 게시물 유형이 학생 과제물을 지원하는지 확인합니다. supportsStudentWork 필드는 활동인 게시물 유형에 대해서만 true일 수 있습니다.

부가기능 첨부파일이 연결된 스트림 항목에 액세스할 수 있나요?

예. 하나 이상의 부가기능 첨부파일이 포함된 Announcement, CourseWork 또는 CourseWorkMaterial를 get 또는 patch할 수 있습니다. CourseWork StudentSubmission을 reclaim, return 또는 turnIn할 수 있습니다.

싱글 사인온(SSO)

예, Google 로그인을 계속 사용할 수 있습니다.

Gmail 액세스 권한이 없는 학생도 올바른 형식의 이메일 주소가 있나요?

Gmail 액세스 권한이 있는지 여부와 관계없이 모든 Google Workspace for Education 사용자에게는 Google ID가 있습니다. 특정 Google 서비스 (Gmail 포함)의 ID와 액세스는 서로 다릅니다. Gmail이 사용 중지되어도 학생 사용자는 이메일 주소로 클래스룸에 로그인할 수 있습니다. ID는 사용자 ID와 이메일 주소로 표시됩니다. Google Workspace for Education 사용자는 이메일 주소를 변경할 수 있으므로 사용자 정보를 저장할 때는 사용자 ID를 기본 키로 사용하는 것이 좋습니다.

학생이 로그인할 수 있도록 학교 관리자가 앱을 사전 승인해야 하나요?

도메인 관리자가 부가기능을 설치하려면 먼저 부가기능을 허용 목록에 추가해야 합니다. 선택적으로 도메인 관리자는 도메인 또는 조직 단위 내 모든 사용자를 위해 부가기능을 설치할 수 있습니다.

의견 및 일반적인 질문

기능 요청이나 문제 요청을 제출하려면 어떻게 해야 하나요?

공개 문제 추적기에서 기능 요청을 제출하고, 확인하고, 투표할 수 있습니다.

클래스룸 API에 새로운 기능이 제공되는 시기를 어떻게 알 수 있나요?

API 업데이트는 개발자 뉴스레터와 공개 Issue Tracker에 게시됩니다.

Classroom API를 사용하고 있습니다. 기술 관련 질문은 어떻게 할 수 있나요?

google-classroom 태그를 사용하여 Stack Overflow에 질문을 게시하세요.