API Google Lớp học cung cấp một giao diện lập trình để các nhà phát triển phần mềm, quản trị viên và lãnh đạo trường học quản lý các tài nguyên của Google Lớp học. Bạn có thể tạo phần mềm để tạo, truy xuất và sửa đổi các khoá học trên Lớp học cũng như nội dung của các khoá học đó.
Sau đây là một số trường hợp sử dụng thường gặp:
- Quản lý khoá học, danh sách và người giám hộ
- Thêm bài tập, thông báo và tài liệu khoá học
- Chấm điểm và sửa đổi chế độ cài đặt chấm điểm
- Tạo dữ liệu để phân tích
- Giúp người dùng khám phá và truy cập vào nội dung hoặc công cụ của một nhà cung cấp bên ngoài trong Lớp học
API Lớp học có phải là giải pháp phù hợp với tôi không?
Google cung cấp một số sản phẩm giúp bạn tương tác với Lớp học. Sau đây là một số trường hợp phổ biến và đề xuất về những sản phẩm có thể phù hợp nhất với nhu cầu của bạn.
Sửa đổi tài nguyên trên Google Lớp học
| Trường hợp | Giải pháp đề xuất |
|---|---|
| Tôi muốn thường xuyên quản lý một số lượng lớn các khoá học, người dùng hoặc các tài nguyên khác trong Lớp học. Tôi có thể viết mã và duy trì cơ sở hạ tầng phần mềm. | Viết các ứng dụng sử dụng API Lớp học. |
| Tôi muốn thỉnh thoảng quản lý một số ít tài nguyên trên Lớp học. Tôi có thể viết một lượng nhỏ mã mà không tốn nhiều công sức. | Sử dụng Classroom API với Google Apps Script. |
| Tôi muốn thỉnh thoảng chỉnh sửa từng tài nguyên trong Lớp học. Tôi quen làm việc với các lệnh trên thiết bị đầu cuối. | Sử dụng Trình quản lý Google Apps. |
| Tôi muốn có một số lượng lớn báo cáo có thông tin chi tiết về các sự kiện trong Lớp học. | Sử dụng Dịch vụ chuyển dữ liệu của BigQuery. |
| Tôi muốn điều tra hoạt động của người dùng. | Tạo báo cáo trong Bảng điều khiển dành cho quản trị viên hoặc sử dụng Reports API. |
Tích hợp với Google Lớp học
| Trường hợp | Giải pháp đề xuất |
|---|---|
| Tôi muốn giáo viên và học viên xem và chạy nội dung của tôi trong Lớp học. | Tạo một tiện ích bổ sung cho Lớp học. |
| Tôi muốn giáo viên nhấp vào một nút trên trang web hoặc ứng dụng của tôi để nhúng nội dung của tôi vào Classroom. | Tạo một tiện ích bổ sung Lớp học và tạo tệp đính kèm theo phương thức lập trình. |
| Tôi muốn giáo viên nhấp vào một nút trên trang web hoặc ứng dụng của tôi để liên kết đến nội dung của tôi trong Lớp học. | Tạo bài tập trên lớp bằng API Lớp học hoặc nhúng các nút Chia sẻ với Lớp học. |
| Tôi muốn giáo viên Lớp học đồng bộ hoá hoặc nhập thông tin từ Hệ thống thông tin học sinh của tôi. | Triển khai OneRoster cho SIS hoặc tạo và truy cập vào các tài nguyên bằng API Lớp học. |
Bắt đầu
Nhà phát triển mới nên làm những việc sau trước khi bắt đầu một dự án mới:
- Đọc hướng dẫn của chúng tôi về cấu trúc Classroom API.
- Đọc về cấp độ, các loại người dùng, điều kiện để người dùng đủ điều kiện và các hành động của quản trị viên. Các hướng dẫn này giải thích những khái niệm riêng biệt của Google Lớp học và Classroom API.
- Tìm hiểu cách hoạt động của các yêu cầu API Lớp học.
Để bắt đầu phát triển, hãy đảm bảo bạn đã hoàn tất các bước tiên quyết. Chọn phạm vi Classroom API phù hợp với nhu cầu của bạn, sau đó thiết lập môi trường và bắt đầu đưa ra các yêu cầu bằng cách làm theo một trong các hướng dẫn bắt đầu nhanh:
Thử nghiệm bằng Google APIs Explorer
Để thử nghiệm các phương thức gọi trên dữ liệu trực tiếp, hãy thử dùng Google APIs Explorer. Bạn không cần viết mã để bắt đầu, nhưng hãy lưu ý rằng những thao tác bạn thực hiện bằng Trình khám phá API có thể sửa đổi dữ liệu hiện có.
Một cách để bắt đầu gọi các phương thức là gọi phương thức courses.list(). Phương thức này không yêu cầu tham số yêu cầu nào và bạn có thể truy xuất một id từ danh sách khoá học được trả về để dùng làm tham số yêu cầu cho các lệnh gọi API khác. Nếu chưa có khoá học nào, bạn có thể tạo một khoá học bằng phương thức courses.create().
Bạn cũng có thể khám phá tài liệu tham khảo về API Lớp học.