Google Classroom API 범위 선택

이 문서에는 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.addons.teacher 요청하는 Google Cloud 프로젝트의 첨부파일을 확인, 생성, 업데이트하여 Google 클래스룸에서 가르치는 수업의 항목을 스트리밍합니다.
https://www.googleapis.com/auth/classroom.addons.student Google 클래스룸에서 항목을 스트리밍하기 위해 요청하는 Google Cloud 프로젝트의 첨부파일을 확인하고 업데이트합니다.
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 클래스룸에서 주제를 확인합니다.