개요

Google Classroom API는 소프트웨어 개발자, 관리자, 학교 지도자가 Google Classroom 리소스를 관리할 수 있는 프로그래밍 인터페이스를 제공합니다. 클래스룸 수업과 콘텐츠를 만들고, 검색하고, 수정하는 소프트웨어를 빌드할 수 있습니다.

몇 가지 일반적인 사용 사례는 다음과 같습니다.

  • 수업, 출석부, 보호자 관리
  • 과제, 공지사항, 강의 자료 추가
  • 성적 할당 및 성적 설정 수정
  • 분석을 위한 데이터 생성
  • 외부 제공업체의 콘텐츠 또는 도구를 클래스룸 내에서 검색하고 액세스할 수 있도록 설정

Classroom API가 나에게 적합한 솔루션인가요?

Google에서는 Classroom과 상호작용하는 데 도움이 되는 여러 제품을 제공합니다. 다음은 일반적인 시나리오와 필요에 가장 적합한 제품에 대한 권장사항입니다.

Google 클래스룸 리소스 수정

시나리오 추천 솔루션
많은 수의 수업, 사용자 또는 기타 클래스룸 리소스를 정기적으로 관리하고 싶습니다. 코드를 작성하고 소프트웨어 인프라를 유지하는 데 익숙합니다. Classroom API를 사용하는 애플리케이션을 작성합니다.
가끔 소량의 클래스룸 리소스를 관리하고 싶습니다. 오버헤드가 적은 소량의 코드를 작성하는 데는 문제가 없습니다. Google Apps Script와 함께 Classroom API를 사용합니다.
개별 클래스룸 리소스를 가끔 변경하고 싶습니다. 터미널 명령어를 사용하는 데 익숙합니다. Google Apps Manager를 사용합니다.
Classroom의 이벤트에 관한 세부정보가 포함된 보고서를 대량으로 받고 싶습니다. BigQuery Data Transfer Service를 사용합니다.
사용자 활동을 조사하고 싶습니다. 관리 콘솔에서 보고서를 생성하거나 Reports API를 사용합니다.

Google 클래스룸과 통합

시나리오 추천 솔루션
교사와 학생이 클래스룸에서 내 콘텐츠를 보고 실행할 수 있도록 하고 싶습니다. 클래스룸 부가기능을 빌드합니다.
교사가 내 웹사이트 또는 앱에서 버튼을 클릭하여 내 콘텐츠를 클래스룸에 삽입할 수 있도록 하고 싶습니다. 클래스룸 부가기능을 빌드하고 프로그래매틱 방식으로 첨부파일을 만듭니다.
교사가 내 웹사이트 또는 앱에서 버튼을 클릭하여 클래스룸의 내 콘텐츠로 연결되도록 하고 싶습니다. 클래스룸 API를 사용하여 수업 자료를 만들거나 클래스룸에 공유 버튼을 삽입합니다.
클래스룸 교사가 학생 정보 시스템의 정보를 동기화하거나 가져오도록 하고 싶습니다. SIS용 OneRoster를 구현하거나 Classroom API를 사용하여 리소스를 만들고 액세스합니다.

시작하기

새 개발자는 새 프로젝트를 시작하기 전에 다음을 수행하는 것이 좋습니다.

개발을 시작하려면 기본 요건 단계를 완료해야 합니다. 필요에 따라 적절한 Classroom API 범위를 선택한 다음 환경을 설정하고 빠른 시작 중 하나를 따라 요청을 시작합니다.

Google API 탐색기로 실험하기

실시간 데이터에서 메서드 호출을 실험하려면 Google API 탐색기를 사용해 보세요. 시작하기 위해 코드를 작성할 필요는 없지만 API 탐색기를 사용하여 실행하는 작업이 기존 데이터를 수정할 수 있습니다.

메서드 호출을 시작하는 한 가지 방법은 courses.list() 메서드를 호출하는 것입니다. 이 메서드에는 요청 매개변수가 필요하지 않으며 반환된 과정 목록에서 id를 가져와 다른 API 호출의 요청 매개변수로 사용할 수 있습니다. 강의가 없는 경우 courses.create() 메서드를 사용하여 강의를 만들 수 있습니다.

Classroom API 참조를 살펴볼 수도 있습니다.