Google Classroom API는 소프트웨어 개발자, 관리자, 학교 지도자가 Google 클래스룸 리소스를 관리할 수 있는 프로그래밍 인터페이스를 제공합니다. 클래스룸 과정과 콘텐츠를 만들고, 검색하고, 수정하는 소프트웨어를 빌드할 수 있습니다.
몇 가지 일반적인 사용 사례는 다음과 같습니다.
- 과정, 명단, 보호자 관리
- 과제, 공지사항, 강의 자료 추가
- 성적 부여 및 평가 설정 수정
- 분석을 위한 데이터 생성
- 외부 제공업체의 콘텐츠 또는 도구를 클래스룸 내에서 검색하고 액세스할 수 있도록 만들기
Classroom API가 나에게 적합한 솔루션인가요?
Google은 클래스룸과 상호작용하는 데 도움이 되는 여러 제품을 제공합니다. 다음은 사용자의 니즈에 가장 잘 맞는 제품을 위한 몇 가지 일반적인 시나리오와 권장사항입니다.
Google 클래스룸 리소스 수정하기
시나리오 | 추천 솔루션 |
---|---|
대량의 과정, 사용자 또는 기타 클래스룸 리소스를 정기적으로 관리하려고 합니다. 코드를 작성하고 소프트웨어 인프라를 유지관리하는 데 능숙합니다. | Classroom API를 사용하는 애플리케이션을 작성합니다. |
가끔 소량의 클래스룸 리소스를 관리하고 싶습니다. 오버헤드가 적은 소량의 코드를 편하게 작성할 수 있습니다. | Google Apps Script에서 Classroom API를 사용합니다. |
가끔 개별 클래스룸 리소스를 변경하고 싶습니다 터미널 명령어를 능숙하게 사용합니다. | Google Apps Manager를 사용합니다. |
클래스룸의 활동에 관한 세부정보가 포함된 대량의 보고서를 원합니다. | BigQuery Data Transfer Service를 사용합니다. |
사용자 활동을 조사하고 싶습니다. | 관리 콘솔에서 보고서를 생성하거나 Reports API를 사용합니다. |
Google 클래스룸과 통합
시나리오 | 추천 솔루션 |
---|---|
교사와 학생이 클래스룸에서 내 콘텐츠를 보고 실행할 수 있도록 하려면 어떻게 해야 하나요? | 클래스룸 부가기능을 빌드합니다. |
교사가 웹사이트 또는 앱에서 클릭하면 클래스룸에 콘텐츠가 삽입되도록 하려면 어떻게 해야 하나요? | 클래스룸 부가기능을 빌드하고 프로그래매틱 방식으로 첨부파일을 만듭니다. |
교사가 웹사이트 또는 앱의 버튼을 클릭하여 클래스룸의 콘텐츠로 연결되도록 하려면 어떻게 해야 하나요? | 클래스룸 API를 사용하여 과제물 만들기 또는 클래스룸에 공유 버튼 삽입 |
클래스룸 교사가 내 학생 정보 시스템과 동기화하거나 학생 정보 시스템에서 정보를 가져오도록 하려면 어떻게 해야 하나요? | SIS용 OneRoster를 구현하거나 Classroom API를 사용하여 리소스를 만들고 액세스합니다. |
시작하기
초보 개발자는 새 프로젝트를 시작하기 전에 다음을 수행하는 것이 좋습니다.
- Classroom API 구조 가이드를 읽어보세요.
- 성적, 사용자 유형, 사용자 자격 요건, 관리자 작업에 대해 알아보세요. 이 가이드에서는 Google 클래스룸 및 Classroom API의 고유한 개념을 설명합니다.
- Classroom API 요청의 작동 방식을 이해합니다.
개발을 시작하려면 기본 요건 단계를 완료해야 합니다. 필요에 맞는 적절한 Classroom API 범위를 선택한 다음 환경을 설정하고 빠른 시작 중 하나에 따라 요청을 시작합니다.
Google API 탐색기로 실험
실시간 데이터에서 메서드 호출을 실험하려면 Google API 탐색기를 사용해 보세요. 시작할 때 코드를 작성할 필요는 없지만 API 탐색기를 사용하여 실행하면 기존 데이터가 수정될 수 있습니다.
메서드 호출을 시작하는 한 가지 방법은 courses.list()
메서드를 호출하는 것입니다. 이 메서드에는 요청 매개변수가 필요하지 않으며 반환된 과정 목록에서 id
를 가져와 다른 API 호출의 요청 매개변수로 사용할 수 있습니다. 과정이 없는 경우 courses.create()
메서드를 사용하여 만들 수 있습니다.
Classroom API 참조를 살펴볼 수도 있습니다.