Câu hỏi thường gặp

Xem, tạo và sửa đổi Bài tập trên lớp trong Lớp học

Tôi có thể tạo những gì bằng các điểm cuối CourseWork trong API Lớp học?

Các điểm cuối này cho phép nhà phát triển xem và quản lý bài tập trong một lớp học. Cụ thể, bạn có thể làm tất cả những việc sau:

  • Xem bài tập và câu hỏi (gọi chung là CourseWork) của một người dùng.
  • Tạo, sửa đổi và xoá CourseWork.
  • Đính kèm tài liệu (tệp trên Drive, video trên YouTube, đường liên kết) vào CourseWork.
  • Thay đổi trạng thái của bài nộp của học viên (chẳng hạn như nộp bài, trả bài, lấy lại bài).
  • Đặt điểm cho bài tập đã nộp.
  • Đính kèm tài liệu (tệp trên Drive, video trên YouTube, đường liên kết) vào bài tập đã nộp của học viên.

Một số trường hợp sử dụng mẫu cho CourseWork:

  • Sổ điểm, SIS hoặc hệ thống báo cáo có thể đồng bộ hoá bài tập và điểm từ Lớp học sang các ứng dụng của họ, giúp loại bỏ việc chuyển dữ liệu theo cách thủ công.
  • Các ứng dụng học tập có thể tạo bài tập mới xuất hiện trong luồng lớp học. Khi học viên hoàn thành bài tập, các ứng dụng có thể nộp bài tập, đặt điểm, đính kèm bài tập của học viên và lưu trữ bài tập trong các thư mục thích hợp trên Drive.
  • Người dùng là giáo viên có thể tạo bài tập có tệp đính kèm bằng tiện ích bổ sung trên trang web hoặc ứng dụng của bạn.
  • Người dùng là học viên có thể nộp bài tập có tệp đính kèm là tiện ích bổ sung của bạn.

Ứng dụng của tôi cần có những quyền gì để tạo hoặc sửa đổi bài tập?

Thông thường, một ứng dụng chỉ có thể sửa đổi công việc mà ứng dụng đó tạo ra. Nói cách khác, mọi yêu cầu API để sửa đổi CourseWork đều phải sử dụng cùng một mã dự án Google Cloud đã dùng để tạo CourseWork.

Tiện ích bổ sung Google Lớp học có trường hợp ngoại lệ đối với quy tắc này. Một dự án trên đám mây có thể truy cập hoặc sửa đổi mọi thông báo, bài tập hoặc tài liệu có một hoặc nhiều tệp đính kèm tiện ích bổ sung. Dự án trên đám mây cũng có thể nộp, lấy lại hoặc trả lại bài tập có một hoặc nhiều tệp đính kèm bổ trợ.

Các yêu cầu API cũng cần có phạm vi người dùng chính xác. Giáo viên có thể xem bài tập, tạo bài tập, đính kèm đường liên kết vào bài tập đã nộp và đặt điểm cho bài tập đã nộp. Học viên có thể xem bài tập, đính kèm đường liên kết vào hồ sơ bài tập, cũng như nộp và lấy lại bài tập đã nộp. Quản trị viên miền có thể xem CourseWork nhưng không có quyền ghi.

Ứng dụng của tôi có thể đính kèm những loại mục nào vào bài tập hoặc bài tập đã nộp?

API này hỗ trợ việc đính kèm tệp trên Drive, video trên YouTube và đường liên kết. Chúng tôi chưa hỗ trợ việc đính kèm biểu mẫu gốc của Google.

Người dùng cuối có biết rằng bài tập trong Lớp học là do ứng dụng của tôi tạo không?

Có. Giao diện người dùng của Lớp học xác định bài tập được tạo bên ngoài bằng tên sản phẩm của dự án Google Cloud đã tạo bài tập đó. Người dùng có thể báo cáo công việc được tạo bên ngoài là không mong muốn, cũng như ngắt kết nối ứng dụng đã tạo công việc bằng cách thu hồi mọi thông tin đăng nhập mà người dùng đã cấp cho ứng dụng.

Nút chia sẻ trong Lớp học và các công cụ tích hợp khác

Tôi đã tích hợp với nút chia sẻ trên Lớp học. Tôi có thể sửa đổi bài tập được tạo bằng nút chia sẻ không?

Không. Để sửa đổi một bài tập, yêu cầu phải sử dụng cùng một dự án Google Cloud đã tạo bài tập đó.

Tôi có thể trả lời câu hỏi trong API không?

Không. Bạn có thể tạo và sửa đổi câu hỏi.

Tiện ích bổ sung dành cho Lớp học

Cấu hình dự án

Tôi có thể chuyển đổi một dự án Google Cloud riêng tư mà tôi đã dùng trong quá trình phát triển thành một dự án công khai mà tôi có thể dùng trong quá trình phát hành công khai không?

Không, bạn không thể chuyển đổi một dự án riêng tư trên Google Cloud thành dự án công khai. Bạn cần có 2 dự án riêng biệt, một dự án để phát triển và một dự án để sản xuất.

Một dự án duy nhất trên Google Cloud có thể có hai trang thông tin trên Google Workspace Marketplace không?

Không. Bạn không thể tạo 2 trang thông tin trên Google Workspace Marketplace cho một dự án duy nhất trên Google Cloud.

Tuy nhiên, bạn có thể gói các tiện ích bổ sung. Thao tác này cho phép một trang thông tin duy nhất trên Google Workspace Marketplace đại diện cho nhiều tiện ích bổ sung. Sau đó, việc cài đặt từ trang thông tin như vậy sẽ cài đặt tất cả các tiện ích bổ sung trong gói cùng một lúc. Người dùng cần phải đồng ý với tất cả các phạm vi mà các tiện ích bổ sung đi kèm cần khi uỷ quyền.

Có thể dùng lại ứng dụng OAuth của một dự án Google Cloud khác với một dự án Google Cloud cho tiện ích bổ sung Lớp học không?

Không, ứng dụng OAuth từ một dự án trên Google Cloud khác với dự án trên Google Cloud của tiện ích bổ sung Lớp học không thể hoạt động. Classroom API từ chối mã truy cập do một dự án khác trên Google Cloud tạo. Bạn phải tạo một ứng dụng OAuth riêng cho dự án tiện ích bổ sung.

Trải nghiệm người dùng

Biểu trưng của chúng tôi không phù hợp với một hình vuông nhỏ. Vậy có những lựa chọn nào về kích thước cho biểu trưng trong thanh tiêu đề iframe của tiện ích bổ sung Lớp học?

Thanh tiêu đề iframe được thiết kế chỉ hỗ trợ biểu trưng hình vuông 32x32. Lựa chọn này được đưa ra để phù hợp với hình dạng biểu tượng trang web mà các công ty sử dụng trên trang web của họ. Chúng tôi cũng khuyến khích bạn sử dụng cùng một biểu trưng trong không gian này để đảm bảo tính nhất quán của thương hiệu.

Miền

Tất cả giáo viên và học viên trên cùng một miền có quyền truy cập vào một tiện ích bổ sung đã cài đặt không?

Quản trị viên miền có thể kiểm soát những giáo viên có thể xem tiện ích bổ sung đã cài đặt. Chỉ những người dùng có giấy phép Teaching & Learning hoặc Education Plus mới có thể sử dụng tiện ích bổ sung Lớp học.

Quản trị viên miền tương tác với tiện ích bổ sung như thế nào?

Quản trị viên miền kiểm soát những người có thể sử dụng tiện ích bổ sung của bạn. Họ có thể cài đặt một tiện ích bổ sung cho toàn bộ miền bằng cách sử dụng lựa chọn cài đặt của quản trị viên. Nếu tiện ích bổ sung của bạn có thể được cài đặt riêng lẻ, hãy lưu ý rằng hầu hết quản trị viên đều duy trì một danh sách cho phép tiện ích bổ sung; giáo viên có trong danh sách này có thể tự cài đặt tiện ích bổ sung. Quản trị viên cũng có thể chọn cài đặt riêng tiện ích bổ sung của bạn cho mục đích kiểm thử.

Quản trị viên cũng có thể quan tâm đến số liệu thống kê về mức sử dụng liên quan đến tiện ích bổ sung của bạn. Nếu sản phẩm của bạn hỗ trợ, hãy cân nhắc việc cung cấp số liệu thống kê về việc sử dụng tiện ích bổ sung trong chế độ xem của quản trị viên trên trang web của riêng bạn.

API

Đâu là cách đáng tin cậy để biết liệu nội dung của tiện ích bổ sung có được tải trong iframe hay thẻ mới không?

Hiện tại, không có phương pháp nào để phân biệt hai loại này.

Những mục bài tập nào có iframe Kiểm tra bài tập của học viên?

Khung hiển thị nội tuyến Đánh giá bài làm của học viên chỉ được cung cấp cho tệp đính kèm thuộc loại hoạt động. Gọi phương thức courses.courseWork.getAddOnContext để cho biết loại bài đăng có hỗ trợ bài tập của học viên hay không. Trường supportsStudentWork chỉ có thể là true đối với loại bài đăng là một hoạt động.

Tệp đính kèm có tiện ích bổ sung có thể truy cập vào mục trong luồng mà nó được đính kèm không?

Có. Bạn có thể get hoặc patch bất kỳ Announcement, CourseWork hoặc CourseWorkMaterial nào chứa ít nhất một tệp đính kèm bổ sung của bạn. Bạn có thể reclaim, return hoặc turnIn một CourseWork StudentSubmission.

Đăng nhập một lần

Có, họ vẫn có thể sử dụng tính năng Đăng nhập bằng Google.

Mọi học viên đều có địa chỉ email hợp lệ, ngay cả khi họ không có quyền truy cập vào Gmail?

Mỗi người dùng Google Workspace for Education đều có một danh tính trên Google, bất kể họ có quyền truy cập vào Gmail hay không. Danh tính và quyền truy cập vào bất kỳ Dịch vụ cụ thể nào của Google (bao gồm cả Gmail) đều khác nhau. Ngay cả khi Gmail bị tắt, người dùng là học viên vẫn có thể đăng nhập vào Lớp học bằng địa chỉ email của mình. Danh tính được biểu thị bằng mã nhận dạng người dùng và địa chỉ email. Người dùng Google Workspace for Education có thể thay đổi địa chỉ email của mình, vì vậy, bạn nên sử dụng mã nhận dạng người dùng làm khoá chính khi lưu trữ thông tin người dùng.

Quản trị viên của trường học có cần phê duyệt trước ứng dụng để cho phép học viên đăng nhập không?

Quản trị viên miền phải đưa vào danh sách cho phép một tiện ích bổ sung thì người dùng mới có thể cài đặt tiện ích đó. Ngoài ra, quản trị viên miền có thể cài đặt một tiện ích bổ sung cho tất cả người dùng trong miền hoặc một đơn vị tổ chức.

Ý kiến phản hồi và câu hỏi chung

Làm cách nào để gửi yêu cầu về tính năng hoặc yêu cầu về vấn đề?

Bạn có thể gửi, xem và bỏ phiếu cho các yêu cầu về tính năng trong công cụ theo dõi lỗi công khai của chúng tôi.

Làm cách nào để biết khi nào có các tính năng mới trong API Lớp học?

Nội dung cập nhật về API được đăng trên bản tin dành cho nhà phát triển và công cụ theo dõi lỗi công khai.

Tôi đang sử dụng API Lớp học. Làm cách nào để đặt câu hỏi về kỹ thuật?

Đăng câu hỏi của bạn trên Stack Overflow kèm theo thẻ google-classroom.