Người dùng của bạn có đang sử dụng Lớp học với Google Meet không? Hãy tham khảo bài viết hướng dẫn nhanh về Apps Script để biết cách điểm danh học viên trong các khóa học của Google Meet.

Tổng quan

API Lớp học cung cấp giao diện RESTful để bạn quản lý các khóa học và phương thức trong Google Lớp học. Ngoài ra, nút chia sẻ của Lớp học cho phép nhà phát triển và chủ sở hữu nội dung bật tính năng chia sẻ nội dung của họ cho Lớp học.

Ai có thể sử dụng API?

Quản trị viên miền G Suite cho Giáo dục có thể sử dụng API để thay mặt giáo viên cung cấp các khoá học, đồng bộ hoá hệ thống thông tin học sinh với Lớp học và nắm được các thông tin cơ bản về những lớp học được dạy trong miền của họ.

Nhà phát triển ứng dụng có thể sử dụng API Lớp học để tích hợp ứng dụng của họ với Lớp học. Các ứng dụng này cần sử dụng OAuth 2.0 để yêu cầu quyền xem lớp học và danh sách từ giáo viên. Quản trị viên có thể hạn chế việc giáo viên và học viên trong miền của họ có thể uỷ quyền cho các ứng dụng truy cập vào dữ liệu Google Lớp học của họ hay không.

Chủ sở hữu trang web và nhà phát triển nội dung có thể sử dụng nút chia sẻ của Lớp học để cho phép học viên và giáo viên chia sẻ nội dung trở lại Lớp học.

Mọi hoạt động tích hợp nút chia sẻ API và Lớp học đều phải tuân thủ Nguyên tắc về thương hiệu của Lớp học.

Tổng quan về API

API Lớp học bao gồm một số loại thực thể tương ứng với lớp, giáo viên và học viên trong giao diện Lớp học. Một số thực thể có các thuộc tính bổ sung dành riêng cho API bên cạnh những thuộc tính khác trong Lớp học. Các loại thực thể chính là:

Để biết thông tin chi tiết về các tài nguyên và phương thức của API, hãy tham khảo Tài liệu tham khảo về API Lớp học.

Siêu dữ liệu và bí danh của khóa học

Khóa học đại diện cho một lớp học, chẳng hạn như "M. Smith số 4, số liệu toán học và số lượng giáo viên được giao, danh sách học viên và siêu dữ liệu. Mỗi khoá học được xác định bằng một mã nhận dạng duy nhất do máy chủ gán. Tài nguyên khoá học sẽ gói gọn mọi siêu dữ liệu về khoá học, chẳng hạn như tên, nội dung mô tả, vị trí và thời gian. Danh sách khoá học được quản lý thông qua các tài nguyên Học viên, Giáo viênLời mời cũng như phương thức của các tài nguyên đó.

Bí danh là các giá trị nhận dạng thay thế cho một lớp có thể được liên kết với một khóa học và được dùng thay cho mã nhận dạng duy nhất. Mỗi bí danh tồn tại trong một không gian tên hạn chế những người có thể tạo và xem bí danh đó. Hai không gian tên được hỗ trợ:

  • Miền: Không gian tên miền hữu ích cho việc tạo các bí danh mà tất cả người dùng cần quyền truy cập, nhưng không dành riêng cho bất kỳ chương trình nào. Ví dụ: bạn nên tạo các trang thông tin thay thế cho một khoá học, chẳng hạn như MATH 127 và COMSCI 127 trong vùng chứa tên miền. Chỉ quản trị viên miền mới có thể tạo bí danh trong vùng chứa tên miền, nhưng tất cả người dùng trong miền đều có thể nhìn thấy bí danh.
  • Dự án dành cho nhà phát triển: Không gian tên của dự án dành cho nhà phát triển sẽ hữu ích cho việc quản lý bí danh dành riêng cho ứng dụng. Ví dụ: Một ứng dụng sử dụng giá trị nhận dạng thay thế cho các khoá học có thể tạo các bí danh để liên kết giá trị nhận dạng đó với các khoá học trong Lớp học. Các bí danh được tạo trong không gian tên này được liên kết với một Bảng điều khiển API của Google cụ thể. Bất kỳ người dùng ứng dụng nào cũng có thể tạo và xem các bí danh trong không gian tên của dự án nhà phát triển ứng dụng đó.

Để biết thêm thông tin về cách quản lý siêu dữ liệu và bí danh của khoá học, hãy xem phần Quản lý khoá học.

Danh sách người dùng và danh sách khóa học

Học viênGiáo viên là các mối liên kết cụ thể giữa hồ sơ người dùng và khoá học, thể hiện vai trò của người dùng đó trong khoá học. Việc chỉ định học viên và giáo viên không phải là toàn cầu: người dùng có thể được chỉ định làm giáo viên cho một khóa học và học viên trong một khóa học khác. Chỉ định "student" hoặc "teacher" thể hiện một nhóm quyền cho một người dùng cụ thể trong một khoá học cụ thể.

Học sinh
Tài nguyên học viên là một người dùng đã đăng ký tham gia một khoá học cụ thể. Học viên được phép xem thông tin chi tiết về khoá học và giáo viên của khoá học đó.
Giáo viên
Tài nguyên của giáo viên thể hiện một người dùng đang giảng dạy một khóa học cụ thể. Giáo viên được phép xem và thay đổi thông tin chi tiết về khoá học, xem giáo viên và học viên, cũng như quản lý giáo viên và học viên khác.

Lời mời và phương pháp liên kết của chúng mang đến một cách thuận tiện để thêm học viên và giáo viên vào các khoá học. Khi bạn tạo lời mời, người dùng có thể chọn tham gia một khoá học hay không, thay vì trực tiếp thêm họ qua tài nguyên của giáo viên và học viên.

Hồ sơ người dùng thể hiện bản đồ ánh xạ với hồ sơ miền của người dùng như được xác định bằng mã nhận dạng duy nhất hoặc địa chỉ email của người dùng mà SDK quản trị của Google trả về. Người dùng hiện tại cũng có thể tham chiếu đến mã nhận dạng của riêng họ bằng cách viết tắt "me".

Để biết thêm thông tin về cách quản lý danh sách, hãy xem phần Quản lý giáo viên và học viên.

Bài tập và bài tập mà học viên nộp

Mục CourseWork biểu thị một bài tập được giao cho một nhóm học viên trong một khoá. Báo cáo này chứa các thông tin chi tiết như nội dung mô tả, ngày đến hạn và tài liệu cũng như siêu dữ liệu như thời gian tạo. Tài liệu bao gồm tiêu đề, hình thu nhỏ và URL, cũng như giá trị nhận dạng có thể được sử dụng với các API thích hợp (ví dụ: Drive, YouTube).

Các mục của WorkWork mô tả một trong các loại tác vụ sau:

  • Bài tập mà học viên cần hoàn thành bằng cách gửi trang tính hoặc các tệp đính kèm khác.
  • Một câu hỏi trả lời ngắn hoặc câu hỏi trắc nghiệm.

Bài tập của học viên cho một mục Khóa học được biểu thị bằng Bài tập của học viên. Dữ liệu này bao gồm một phản hồi và siêu dữ liệu bổ sung như trạng thái và cấp được chỉ định.

Nội dung của một SubSubmission phụ thuộc vào loại của mục CourseWork tương ứng:

  • Các trang tính và tệp đính kèm đã gửi cho một bài tập, bao gồm cả tiêu đề, hình thu nhỏ và URL, cũng như giá trị nhận dạng có thể dùng với các API thích hợp như Drive hoặc YouTube.
  • Câu trả lời cho một câu hỏi trả lời ngắn hoặc câu hỏi trắc nghiệm.

Để biết thêm thông tin về cách quản lý bài tập khóa học và bài tập học viên nộp, hãy xem Quản lý bài tập trên lớp.

Bắt đầu

Để thiết lập môi trường và bắt đầu ngay với API này, hãy thử một trong các bước bắt đầu nhanh:

Bạn cũng có thể khám phá tài liệu tham khảo API.