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à khóa học trong Google Lớp học. Ngoài ra, nút Chia sẻ 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ọ với 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 khóa học theo phương thức lập trình, đồng bộ hóa hệ thống thông tin học viên với Lớp học và xem thông tin cơ bản về các lớp học được giảng dạy trong miền của họ.

Các 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ế xem giáo viên và học viên trong miền của họ có thể cho phép ứ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ẻ trong Lớp học để cho phép học viên và giáo viên chia sẻ nội dung lại vớ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 theo nguyên tắc sử dụng 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 các lớp học, giáo viên và học viên trong giao diện Lớp học. Một số thực thể này có các thuộc tính bổ sung dành riêng cho API, ngoài những thuộc tính 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, chẳng hạn như "M. Smith trong kỳ 4, toán học và các giáo viên được chỉ định, danh sách học viên và siêu dữ liệu. Mỗi khóa học được xác định bởi một mã nhận dạng duy nhất do máy chủ chỉ định. Tài nguyên về khóa học bao gồm tất cả siêu dữ liệu về khóa học, chẳng hạn như tên, nội dung mô tả, vị trí và thời gian. Danh sách khóa học được quản lý thông qua tài nguyên Học viên, Giáo viênLời mời và phương thức của họ.

Email đại diện 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 có trong một vùng chứa tên hạn chế người có thể tạo và xem nội dung đó. Hai vùng chứa tên được hỗ trợ:

  • Miền: Vùng chứa tên miền rất hữu ích để tạo bí danh mà tất cả người dùng cần có 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ụ: danh sách thay thế cho một khóa học, chẳng hạn như MATH 127 và COMSCI 127, nên được tạo trong vùng chứa tên miền. Bí danh trong vùng chứa tên miền chỉ có thể do quản trị viên miền tạo ra nhưng hiển thị cho tất cả người dùng trong miền.
  • Dự án dành cho nhà phát triển: Vùng chứa tên dự án dành cho nhà phát triển rất hữu ích trong 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 khóa học có thể tạo bí danh để liên kết giá trị nhận dạng với các khóa học. Lớp học. Bí danh được tạo trong vùng chứa tên này được gắn với một Bảng điều khiển API Google cụ thể. Người dùng của một ứng dụng có thể tạo và xem các email đại diện trong vùng chứa tên dành cho dự án của nhà phát triển đó.

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

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

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à một khóa học, thể hiện vai trò của người dùng đó trong khóa họ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à một học viên ở khóa học khác. Việc chỉ định "student" or "teacher" đại diện cho 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 dành cho sinh viên đại diện cho người dùng đã đăng ký với tư cách là học viên trong một khóa học cụ thể. Học viên được phép xem thông tin chi tiết về khóa học và giáo viên của khóa học đó.
Giáo viên
Tài nguyên dành cho giáo viên đại diện cho người dùng dạy một khóa học cụ thể. Giáo viên được phép xem và thay đổi chi tiết khóa học, xem giáo viên và học viên, đồng thời quản lý giáo viên và học viên bổ sung.

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

Hồ sơ người dùng biểu thị mối liên kết 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 do SDK quản trị viên 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 sử dụng tính năng rút gọn "me".

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

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

Một mục courseWork biểu thị một nhiệm vụ duy nhất được giao cho một nhóm học viên trong một khóa học. Thẻ này chứa các 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ể dùng với các API phù hợp (tức là Drive, YouTube).

Các mục trong Khóa học mô tả một trong các loại nhiệm vụ sau:

  • Bài tập mà học viên hoàn thành bằng cách gửi trang tính hoặc tệp đính kèm khác.
  • 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 CourseWork được biểu thị bằng studentSubmission. Dữ liệu này bao gồm nội dung phản hồi và siêu dữ liệu bổ sung như trạng thái và điểm đã chỉ định.

Nội dung của Bài tập dành cho học viên phụ thuộc vào loại mục Bài tập của khóa học tương ứng:

  • Các trang tính và tệp đính kèm mà bạn đã nộp cho một bài tập, bao gồm tiêu đề, hình thu nhỏ và URL, cũng như những giá trị nhận dạng có thể dùng với các API phù 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 một 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 của khóa học và bài tập mà học viên nộp, hãy xem phần Quản lý Bài tập trên lớp.

Bắt đầu

Để thiết lập môi trường của bạn và bắt đầu ngay lập tức bằng API, hãy thử một trong những bắt đầu nhanh sau:

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