Chọn phạm vi API Google Lớp học

Tài liệu này trình bày thông tin xác thực và thông tin uỷ quyền dành riêng cho API Google Lớp học. Trước khi đọc tài liệu này, hãy nhớ đọc thông tin chung về việc xác thực và uỷ quyền của Google Workspace tại bài viết Tìm hiểu về việc xác thực và uỷ quyền.

Định cấu hình OAuth 2.0 để uỷ quyền

Định cấu hình màn hình xin phép bằng OAuth và chọn phạm vi để xác định thông tin nào sẽ hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể phát hành vào lúc khác.

Phạm vi của API Lớp học

Để xác định cấp truy cập được cấp cho ứng dụng, bạn cần xác định và khai báo phạm vi uỷ quyền. Phạm vi uỷ quyền là một chuỗi URI OAuth 2.0 chứa tên ứng dụng Google Workspace, loại dữ liệu mà ứng dụng truy cập và cấp truy cập. Phạm vi là các yêu cầu của ứng dụng để xử lý dữ liệu Google Workspace, bao gồm cả dữ liệu Tài khoản Google của người dùng.

Khi cài đặt ứng dụng, người dùng sẽ được yêu cầu xác thực các phạm vi mà ứng dụng sử dụng. Nhìn chung, bạn nên chọn phạm vi tập trung hẹp nhất có thể và tránh yêu cầu các phạm vi mà ứng dụng không yêu cầu. Người dùng sẵn sàng cấp quyền truy cập vào các phạm vi bị giới hạn và được mô tả rõ ràng hơn.

API Lớp học hỗ trợ các phạm vi sau:

Phạm vi	Ý nghĩa
https://www.googleapis.com/auth/classroom.addons.teacher	Xem, tạo và cập nhật tệp đính kèm của dự án Google Cloud đang yêu cầu để truyền trực tuyến các mục trong lớp học mà bạn dạy trên Google Lớp học.
https://www.googleapis.com/auth/classroom.addons.student	Xem và cập nhật tệp đính kèm của dự án Google Cloud đang yêu cầu để truyền trực tuyến các mục trong Google Lớp học.
https://www.googleapis.com/auth/classroom.announcements	Xem và quản lý thông báo trong Google Lớp học.
https://www.googleapis.com/auth/classroom.announcements.readonly	Xem thông báo trong Google Lớp học.
https://www.googleapis.com/auth/classroom.courses	Xem, chỉnh sửa, tạo và xoá vĩnh viễn các lớp học của bạn trong Google Lớp học.
https://www.googleapis.com/auth/classroom.courses.readonly	Xem các lớp học của bạn trên Google Lớp học.
https://www.googleapis.com/auth/classroom.coursework.me	Xem, tạo và chỉnh sửa các mục trong khoá học, bao gồm cả bài tập, câu hỏi và điểm.
https://www.googleapis.com/auth/classroom.coursework.me.readonly	Xem bài tập và điểm số của bạn trong Google Lớp học.
https://www.googleapis.com/auth/classroom.coursework.students	Quản lý bài tập và điểm số cho học viên trong các lớp Google Lớp học mà bạn giảng dạy, đồng thời xem bài tập và điểm số cho các lớp mà bạn quản lý.
https://www.googleapis.com/auth/classroom.coursework.students.readonly	Xem bài tập và điểm số của học viên trong các lớp Google Lớp học mà bạn dạy hoặc quản lý.
https://www.googleapis.com/auth/classroom.courseworkmaterials	Xem, chỉnh sửa và tạo tài liệu bài tập trên lớp trong Google Lớp học.
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly	Xem tất cả tài liệu bài tập trên lớp cho lớp học của bạn trong Google Lớp học.
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly	Xem người giám hộ của bạn trên Google Lớp học.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Xem và quản lý người giám hộ cho học sinh trong lớp Google Lớp học của bạn.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	Xem người giám hộ cho học sinh trong lớp học trên Google Lớp học.
https://www.googleapis.com/auth/classroom.profile.emails	Xem địa chỉ email của những người trong lớp học của bạn.
https://www.googleapis.com/auth/classroom.profile.photos	Xem ảnh hồ sơ của những người trong lớp học của bạn.
https://www.googleapis.com/auth/classroom.push-notifications	Nhận thông báo về dữ liệu của bạn trên Google Lớp học.
https://www.googleapis.com/auth/classroom.rosters	Quản lý danh sách lớp trên Google Lớp học.
https://www.googleapis.com/auth/classroom.rosters.readonly	Xem bảng phân công lớp học trên Google Lớp học của bạn.
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	Xem điểm số và tài liệu môn học của bạn trong Google Lớp học.
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	Xem bài tập và điểm số của học viên ở những lớp Google Lớp học mà bạn dạy hoặc quản lý.
https://www.googleapis.com/auth/classroom.topics	Xem, tạo và chỉnh sửa các chủ đề trong Google Lớp học.
https://www.googleapis.com/auth/classroom.topics.readonly	Xem các chủ đề trong Google Lớp học.