사용자가 Google Meet에서 클래스룸을 사용 중인가요? Google Meet에서 학생의 참석 여부를 확인하는 방법 관련 Apps Script 빠른 시작을 확인하세요.

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

자주 묻는 질문(FAQ)

클래스룸에서 CourseWork 확인, 만들기, 수정

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

새로운 엔드포인트를 사용하면 개발자가 클래스의 작업을 보고 관리할 수 있습니다. 특히 다음 작업을 모두 실행할 수 있습니다.

사용자의 과제 및 질문('CourseWork'로 통칭) 보기
CourseWork를 만들고 수정하고 삭제합니다.
자료 (Drive 파일, YouTube 동영상, 링크)를 CourseWork에 첨부
학생 제출물 상태 변경 (예: 제출, 반환, 회수)
과제 제출물의 성적 설정하기
학생 제출물에 자료 (Drive 파일, YouTube 동영상, 링크) 첨부

CourseWork의 몇 가지 샘플 사용 사례:

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

할당을 만들거나 수정하는 데 필요한 권한은 무엇인가요?

일반적으로 애플리케이션은 직접 만든 작업만 수정할 수 있습니다. 즉, 모든 할당 변형 API 요청은 할당 생성 시 저장된 것과 동일한 Google Cloud 프로젝트 ID를 사용해야 합니다.

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

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

지원서가 과제나 제출물에 첨부할 수 있는 항목 유형은 무엇인가요?

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

클래스룸에서 내 애플리케이션에서 과제를 만든 사실을 최종 사용자가 알 수 있나요?

예. 클래스룸 UI는 작업을 만든 Google Cloud 프로젝트의 제품 이름을 사용하여 외부에서 생성된 과제를 식별합니다. 사용자는 외부에서 생성된 작업을 원치 않는 것으로 신고할 수 있고 사용자가 애플리케이션에 발급한 사용자 인증 정보를 취소하여 작업을 만든 애플리케이션의 연결을 해제할 수 있습니다.

아직이요. 할당을 수정하려면 할당을 만든 Google Cloud 프로젝트와 동일한 프로젝트를 사용해야 합니다.

API에서 질문에 답변할 수 있나요?

아직이요. 질문을 만들고 수정할 수 있습니다. 프로그래매틱 방식으로 질문에 답변하는 것은 로드맵에 포함되어 있습니다

클래스룸 부가기능

프로젝트 구성

개발 중에 사용한 비공개 Google Cloud 프로젝트를 프로덕션에서 사용할 수 있는 공개 프로젝트로 변환할 수 있나요?

비공개 Google Cloud 프로젝트는 공개 프로젝트로 변환할 수 없습니다. 개발용 프로젝트와 프로덕션용 프로젝트 두 개가 필요합니다.

하나의 Google Cloud 프로젝트에 GWM 등록정보 2개를 포함할 수 있나요?

아니요. 하나의 Google Cloud 프로젝트에 두 개의 GWM 목록을 만들 수 없습니다.

하지만 부가기능을 번들로 추가하는 것은 가능합니다. 이렇게 하면 하나의 GWM 목록에서 여러 부가기능을 나타낼 수 있습니다. 이러한 등록정보에서 설치하면 번들의 모든 부가기능이 한 번에 설치됩니다. 사용자는 승인 시 번들 부가기능에 필요한 모든 범위에 동의해야 합니다.

번들링과 관련하여 다음 두 가지 고려사항이 있습니다.

클래스룸 부가기능은 Teaching & Learning Upgrade 또는 Education Plus SKU 구독자만 사용할 수 있습니다.
부가기능 API는 사전 체험판이며 참여하는 개발자 및 Google Cloud 프로젝트로 제한됩니다. 번들 부가기능이 참여하지 않는 Google Cloud 프로젝트를 사용하는 경우 의도한 대로 작동하지 않을 수 있습니다.

다른 Google Cloud 프로젝트의 OAuth 클라이언트를 클래스룸 부가기능의 Google Cloud 프로젝트에 재사용할 수 있나요?

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

사용자 환경

로고가 작은 정사각형에 잘 맞지 않습니다. iframe 제목 표시줄에 있는 로고에는 어떤 크기 옵션이 있나요?

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

도메인

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

학교 관리자는 설치된 부가기능을 볼 수 있는 교사를 제어할 수 있습니다.

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

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

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

API

파트너 페이지가 iframe 내에서 로드되는지 또는 크게 보기 탭 내에서 로드되는지 알 수 있는 신뢰할 수 있는 방법은 무엇인가요?

현재 이 두 가지를 구분하는 방법은 없습니다.

어떤 할당 가능한 과제물 항목에 학생 과제물 검토 iframe이 적용되나요?

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

사전 체험 프로그램 기간 동안 API에 브레이킹 체인지가 있을 수 있나요?

부가기능 API는 아직 개발 중입니다. 따라서 API에 브레이킹 체인지가 발생하여 이전에 성공한 요청이 실패하거나 다르게 동작할 수 있습니다. 개발자 포럼을 통해 브레이킹 체인지를 미리 받을 수 있습니다.

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

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

클래스룸 부가기능은 언제 공개적으로 출시되나요?

클래스룸 부가기능은 2022년 여름부터 모든 최종 사용자에게 제공됩니다. 부가기능 API는 2024년 중에 개발자에게 정식 버전으로 출시될 예정입니다.

싱글 사인온(SSO)

Clever 배지 또는 Classlink를 사용하여 Chromebook에 로그인하는 학생이 Google 로그인을 사용할 수 있나요?

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

Gmail에 액세스할 수 없는 경우에도 모든 학생이 올바른 형식의 이메일 주소를 가지고 있나요?

모든 Google Workspace for Education 사용자에게는 Gmail 액세스 가능 여부와 관계없이 Google ID가 있습니다. ID는 이메일 주소로 표현됩니다. 특정 Google 서비스 (Gmail 포함)에 대한 ID와 액세스 권한은 서로 다릅니다. 따라서 Gmail이 사용 중지되어 있어도 학생 사용자는 이메일 주소로 로그인할 수 있습니다.

학생이 로그인하도록 허용하려면 학교 관리자가 앱을 사전 승인해야 하나요?

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

의견 및 일반적인 질문

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

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

Classroom API에서 새 기능을 사용할 수 있는 시기를 어떻게 알 수 있나요?

API 업데이트는 출시 노트 페이지, 개발자 포럼, 공개 Issue Tracker에 게시됩니다.

Classroom API를 사용하고 있습니다. 기술적인 질문을 하려면 어떻게 해야 하나요?

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