Tài liệu này chứa thông tin uỷ quyền và xác thực dành riêng cho Google Lớp học API. 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 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 đồ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ể xuất bản ứng dụng sau này.
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 của bạn, 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à yêu cầu của ứng dụng để xử lý dữ liệu trên Google Workspace, bao gồm cả dữ liệu Tài khoản Google của người dùng.
Khi ứng dụng của bạn được cài đặt, 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. Nói 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 của bạn không cần. Người dùng sẵn sàng cấp quyền truy cập vào các phạm vi có giới hạn và được mô tả rõ ràng.
Classroom API 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 yêu cầu đối với các mục trong luồng của các lớp học bạn dạy trong Google Lớp học. |
https://www.googleapis.com/auth/classroom.addons.student
|
Xem và cập nhật các tệp đính kèm của dự án Google Cloud yêu cầu đối với các mục trên luồng 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 bạn dạy và xem bài tập cũng như điểm số cho các lớp 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 học mà bạn dạy hoặc quản lý trên Google Lớp học. |
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ả cá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 viên trong các lớp học của bạn trên Google Lớp học. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Xem người giám hộ cho học viên trong lớp học của bạn 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 Google Lớp học của bạn. |
https://www.googleapis.com/auth/classroom.rosters
|
Quản lý bảng phân công lớp học 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. |
https://www.googleapis.com/auth/classroom.student-submissions.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.student-submissions.students.readonly
|
Xem bài tập và điểm số của học viên trong các lớp học mà bạn dạy hoặc quản lý trên Google Lớp học. |
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. |