Những điểm chính cần cân nhắc

Trang này liệt kê một số hiểu lầm phổ biến và trường hợp hiếm gặp mà bạn có thể muốn cân nhắc khi thiết kế và triển khai tiện ích bổ sung cho Google Lớp học. Bạn nên triển khai các sự kiện an toàn và kiểm thử cho những trường hợp này.

Các khái niệm về Google Lớp học

Phần này nêu bật các trường hợp hiếm gặp và khái niệm liên quan đến các tiện ích bổ sung áp dụng cho mọi dịch vụ của Google Lớp học.

Khoá học và vai trò của người dùng

Khoá học là đơn vị tổ chức trung tâm kết nối giáo viên với học viên. Khoá học là cấp tổ chức cao nhất trong API Google Lớp học.

Người dùng cá nhân có thể được thêm vào một khoá học với tư cách là "giáo viên" hoặc "học viên". Vai trò của người dùng trong khoá học không gắn liền với vai trò của họ trong tổ chức. Điều đó có nghĩa là học viên của trường có thể là giáo viên trong một khoá học, và thành viên giáo viên có thể là học viên trong các khoá học. Trường hợp phổ biến nhất là khoá học đại diện cho một môn học học thuật thường xuyên được lên lịch, còn khoá học cũng được tạo ra để tổ chức các câu lạc bộ sinh viên hoặc phát triển chuyên môn.

Những nội dung sau đây áp dụng cho tất cả khoá học trong Google Lớp học.

Liên quan đến giáo viên khoá học:

  • Một khoá học có thể có nhiều giáo viên.
  • Giáo viên có thể được thêm vào khoá học bất cứ lúc nào.
  • Giáo viên có thể bị xoá khỏi khoá học bất cứ lúc nào.

Mục phát trực tuyến

Các mục trong bảng tin là các phần nội dung đã đăng được chia sẻ với các thành viên của một Khoá học. Nhà phát triển và giáo viên có thể tạo tệp đính kèm bằng tiện ích bổ sung cho 3 loại mục trong luồng: thông báo, bài tập và tài liệu.

Giáo viên sẽ tạo thông báo ở đầu trang Bảng tin trong giao diện người dùng của Lớp học. Giáo viên tạo bài tập và tài liệu bằng cách nhấp vào nút Create (Tạo) trong thẻ Bài tập trên lớp. Nhà phát triển có thể tạo các lớp học này theo phương thức lập trình thông qua API Lớp học.

Bài tập là một mục trên bảng tin có thể chấp nhận bài tập mà học viên đã nộp. Bài tập là loại mục duy nhất trên bảng tin xuất hiện trong sổ điểm có thể chứa tệp đính kèm bằng tiện ích bổ sung.

Về mục trong luồng:

  • Bạn có thể giao một bài tập hoặc tài liệu cho một nhóm nhỏ học viên trong khoá học.
  • Bài tập có thể được chấm điểm hoặc không được chấm điểm. Giáo viên có thể thay đổi trạng thái chấm điểm của một bài tập bất cứ lúc nào.
  • Một bài tập có thể có nhiều tệp đính kèm.
  • Một bài tập có thể có nhiều loại tệp đính kèm. Ví dụ: một bài tập có thể chứa đồng thời các tệp đính kèm trong Google Tài liệu, video trên YouTube và tiện ích bổ sung.
  • Một bài tập có thể có tiện ích bổ sung đính kèm từ nhiều nhà phát triển.
  • Nhà phát triển có thể nhận và sửa đổi thông tin về bất kỳ mục phát trực tuyến nào bằng một trong các tệp đính kèm tiện ích bổ sung của họ.
  • Nhà phát triển có thể nộp, lấy lại hoặc trả lại bài tập mà học viên đã nộp cho một bài tập có chứa một trong các tệp đính kèm của tiện ích bổ sung.
  • Nhà phát triển chỉ có thể đặt điểm cho bài tập mà từng học viên đã nộp trong các bài tập họ tạo.

Các mục đã sao chép trên bảng tin

Giáo viên có thể sao chép một mục trong bảng tin bằng cách sao chép một khoá học, sử dụng lại bài tập hoặc phát hành một mục trong bảng tin cho nhiều khoá học. Hãy đọc hướng dẫn của chúng tôi về nội dung được sao chép để hiểu cách tiện ích bổ sung có thể xử lý các trường hợp này.

Tổ chức của người dùng

API Google Lớp học không trả về giá trị nhận dạng cho tổ chức, toà nhà hoặc bất kỳ gói thành viên nào khác của người dùng cao hơn cấp độ khoá học.