이 문서에는 Google Classroom API 관련 승인 및 인증 정보가 포함되어 있습니다. 이 문서를 읽기 전에 인증 및 승인 알아보기에서 Google Workspace의 일반적인 인증 및 승인 정보를 읽어 보세요.
승인을 위한 OAuth 2.0 구성
OAuth 동의 화면을 구성하고 범위를 선택하여 사용자 및 앱 검토자에게 표시할 정보를 정의하고 나중에 게시할 수 있도록 앱을 등록합니다.
Classroom API 범위
앱에 부여된 액세스 수준을 정의하려면 승인 범위를 식별하고 선언해야 합니다. 승인 범위는 Google Workspace 앱 이름, 액세스하는 데이터의 종류, 액세스 수준이 포함된 OAuth 2.0 URI 문자열입니다. 범위는 사용자의 Google 계정 데이터를 포함하여 Google Workspace 데이터를 사용하기 위한 앱의 요청입니다.
앱이 설치되면 사용자에게 앱에서 사용하는 범위의 유효성을 검사하라는 메시지가 표시됩니다. 일반적으로 가능한 한 가장 좁은 범위의 범위를 선택하고 앱에 필요하지 않은 범위는 요청하지 않아야 합니다. 사용자는 제한적이고 명확하게 설명된 범위에 더 쉽게 액세스 권한을 부여할 수 있습니다.
Classroom API는 다음 범위를 지원합니다.
| 범위 | 의미 |
|---|---|
https://www.googleapis.com/auth/classroom.announcements
|
Google 클래스룸에서 공지사항을 보고 관리합니다. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Google 클래스룸에서 공지사항을 봅니다. |
https://www.googleapis.com/auth/classroom.courses
|
내 Google 클래스룸 수업을 확인, 수정, 생성하고, 영구적으로 삭제합니다. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Google 클래스룸 수업을 확인합니다. |
https://www.googleapis.com/auth/classroom.coursework.me
|
과제, 질문, 성적을 포함한 수업 과제 항목을 확인하고, 만들고, 수정합니다. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Google 클래스룸에서 수업 과제 및 성적을 확인합니다. |
https://www.googleapis.com/auth/classroom.coursework.students
|
내가 가르치는 Google 클래스룸 수업 내 학생들의 수업 과제와 성적을 관리하고 내가 관리하는 수업의 수업 과제와 성적을 봅니다. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
내가 가르치거나 관리하는 Google 클래스룸 수업 내 학생들의 수업 과제 및 성적을 확인합니다. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Google 클래스룸에서 수업 과제 자료를 확인하고, 수정하고, 만들 수 있습니다. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
내 Google 클래스룸 수업의 모든 수업 과제 자료를 확인합니다. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Google 클래스룸 보호자를 확인합니다. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Google 클래스룸 수업에 참여하는 학생의 보호자를 확인하고 관리합니다. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Google 클래스룸 수업에 참여하는 학생의 보호자를 확인합니다. |
https://www.googleapis.com/auth/classroom.profile.emails
|
같은 반 친구의 이메일 주소를 봅니다. |
https://www.googleapis.com/auth/classroom.profile.photos
|
같은 반 친구의 프로필 사진을 봅니다. |
https://www.googleapis.com/auth/classroom.push-notifications
|
Google 클래스룸 데이터에 관한 알림을 받습니다. |
https://www.googleapis.com/auth/classroom.rosters
|
Google 클래스룸 수업 출석부를 관리합니다. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Google 클래스룸 수업 출석부를 확인합니다. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Google 클래스룸에서 수업 과제 및 성적을 확인합니다. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
내가 가르치거나 관리하는 Google 클래스룸 수업 내 학생들의 수업 과제 및 성적을 확인합니다. |
https://www.googleapis.com/auth/classroom.topics
|
Google 클래스룸에서 주제를 보고 만들고 수정합니다. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Google 클래스룸에서 주제 보기 |