Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem tài liệu về tiện ích bổ sung để biết thêm thông tin.

Trang này được dịch bởi Cloud Translation API.

Tương tác với tệp đính kèm

Trang này thảo luận chi tiết về cách triển khai việc tạo tệp đính kèm và làm việc với bài làm mà học viên nộp. Xin lưu ý rằng bạn có thể phải cung cấp thông số liên quan đến tệp đính kèm khi đưa ra các yêu cầu này.

Tạo tệp đính kèm

Tạo tệp đính kèm bằng cách gửi yêu cầu CREATE cho ứng dụng thích hợp điểm cuối courses.*.addOnAttachments.create. Yêu cầu của bạn phải bao gồm thực thể của AddOnAttachment trong nội dung yêu cầu.

Sau đây là các trường bắt buộc khi tạo tệp đính kèm:

title: tên chuỗi của tệp đính kèm.
teacherViewUri: URI cho Chế độ xem dành cho giáo viên của tệp đính kèm.
studentViewUri: URI cho Chế độ xem của học viên của tệp đính kèm.
studentWorkReviewUri: URI để giáo viên xem bài tập của học viên tệp đính kèm. Trường này chỉ bắt buộc đối với các tệp đính kèm thuộc loại hoạt động.

Bạn nên thêm một số trường không bắt buộc sau đây:

dueDate và dueTime nếu bạn chỉ định thời điểm đến hạn đính kèm.
maxPoints: điểm tối đa cho tệp đính kèm. Phải là một giá trị khác 0 nếu bạn muốn hỗ trợ trả điểm về. Áp dụng cho tệp đính kèm loại hoạt động .

Hãy xem tài liệu tham khảo về tài nguyên AddOnAttachment để biết thêm thông tin về các trường này.

Thông tin chi tiết về bài học viên nộp

Quy trình gửi thông thường tuân theo các bước sau:

Học viên chạy studentViewUri để hoàn tất một hoạt động.
Tiện ích bổ sung này truy xuất submissionId từ phương thức getAddOnContext thông qua thông tin đăng nhập của học viên.
submissionId và attachmentId được tiện ích bổ sung lưu trữ nhà phát triển làm giá trị nhận dạng duy nhất cho bài tập của học sinh. Trong trường hợp giáo viên sao chép bài tập trong Lớp học, bạn có thể sử dụng của hai tham số này để hiển thị một tệp đính kèm mới trong bài tập đã sao chép. Hãy xem trang về nội dung được sao chép của chúng tôi để biết thêm chi tiết.
Một giáo viên quan tâm đến việc đánh giá bài làm của học sinh sẽ khởi chạy studentWorkReviewUri. Yêu cầu bao gồm các tham số truy vấn sau: courseId, itemId, itemType, attachmentId và submissionId.
Nhà phát triển tiện ích bổ sung sử dụng 4 mã nhận dạng này để truy xuất bài tập của học viên. Sử dụng điểm cuối courses.courseWork.addOnAttachments.studentSubmissions đến truy xuất hoặc sửa đổi thông tin về bài tập học viên nộp.

Phát hiện trạng thái gửi

Gửi yêu cầu GET cho Điểm cuối courses.courseWork.addOnAttachments.studentSubmissions cần tải chi tiết về một submissionId cụ thể. Bạn nhận được một Đối tượng AddOnAttachmentStudentSubmission chứa điểm của bài tập (pointsEarned) và trạng thái hiện tại (postSubmissionState). Trạng thái gửi có thể là một trong các giá trị sau:

NEW, nếu học viên chưa từng truy cập vào bài nộp.
CREATED, nếu học viên đã tạo bài tập nhưng chưa gửi.
TURNED_IN, nếu học viên đã nộp bài tập cho giáo viên.
RETURNED, nếu giáo viên đã trả lại bài tập đã nộp cho học viên.
RECLAIMED_BY_STUDENT, nếu học viên "chưa gửi" công việc của mình.

Sử dụng điểm cuối này để phát hiện trạng thái bài tập của học viên trong tiện ích bổ sung của bạn. Bạn sau đó có thể điều chỉnh chế độ xem hoặc tuỳ chọn được cung cấp cho học sinh tuỳ theo trạng thái được trả về. Điều này có thể bao gồm các tính năng như:

Hiện trạng thái nộp bài của các bài tập trong tiện ích bổ sung. Việc này có thể giúp học sinh tránh nhầm lẫn có thể xảy ra và đảm bảo các em không nhầm lẫn không thể nộp bài tập.
Hạn chế đặc quyền chỉnh sửa nội dung gửi. Nếu bài tập có trạng thái CREATED hoặc RECLAIMED_BY_STUDENT, học viên có thể được phép chỉnh sửa nội dung họ gửi. Nếu bài tập có trạng thái TURNED_IN hoặc RETURNED, học viên có thể không được phép chỉnh sửa bài nộp.

Điểm và nhiều tệp đính kèm

Bạn chỉ có thể dùng một tệp đính kèm bằng tiện ích bổ sung để đặt điểm cho một tài liệu bài tập. Nếu giáo viên tạo nhiều tệp đính kèm dạng hoạt động cung cấp giá trị maxPoints, chỉ tệp đính kèm đầu tiên như vậy mới có thể đặt giá trị điểm bài tập. Không đặt giá trị maxPoints hoặc đặt giá trị này từ 0 đến vô hiệu hoá tính năng trả điểm về cho một tệp đính kèm.

Đặt điểm cho bài tập

Bạn có thể sửa đổi bài tập học viên đã nộp bằng cách gửi yêu cầu PATCH đến điểm cuối courses.courseWork.addOnAttachments.studentSubmissions. Yêu cầu phải bao gồm một bản sao của AddOnAttachmentStudentSubmission với thuộc tính các giá trị được sửa đổi. Đặt trường pointsEarned để sửa đổi điểm của bài tập đã nộp. Giá trị được truyền vào pointsEarned sẽ trở thành điểm không chính thức mà chương trình giáo viên trong giao diện người dùng Lớp học. Giáo viên có thể sửa đổi điểm không chính thức trước khi trả bài tập cho học viên. Xem Tổng quan về cách chấm điểm trong Giao diện người dùng của Lớp học để xem thông tin chi tiết về điểm số cho giáo viên.

Xin lưu ý rằng bạn chỉ có thể đặt điểm bằng pointsEarned nếu các điều kiện sau là đúng:

Tệp đính kèm phải có giá trị maxPoints dương.
Tiện ích bổ sung phải là người tạo ban đầu của tệp đính kèm.

Ngoài ra, xin lưu ý rằng bạn có thể sửa đổi maxPoints của AddOnAttachment đã tạo bằng cách gửi yêu cầu PATCH đến điểm cuối addOnAttachments.

Trường hợp đặt điểm

Bạn có một số lựa chọn về thời điểm điểm được trả lại cho Google Lớp học. Chiến lược phát hành đĩa đơn điểm khác biệt quan trọng là bạn có chọn lưu trữ thông tin xác thực của giáo viên, như chỉ giáo viên mới có thể sửa đổi điểm.

Có hai khoảnh khắc bổ sung mà bạn có thể đạt điểm Google Lớp học: khi học viên hoàn thành bài tập hoặc khi giáo viên mở bài tập của học viên trong iframe Đánh giá bài tập của học viên.

Nếu muốn thiết lập điểm khi học viên hoàn thành bài tập, bạn phải lưu trữ một thông tin xác thực ngoại tuyến của giáo viên, sau đó truy xuất và sử dụng chúng để sửa đổi điểm khi học viên hoàn thành bài tập. Phương pháp này cung cấp một số lợi ích:

Cung cấp thông tin cập nhật liền mạch về điểm. Giáo viên không cần phải thực hiện bất kỳ thao tác đặc biệt nào để đưa điểm vào giao diện người dùng Lớp học.
Cung cấp thông tin chi tiết theo thời gian thực về tiến độ của một lớp học thông qua một bài tập. Bằng cách đặt điểm khi học viên hoàn tất tệp đính kèm, giáo viên có thể hiểu được của sinh viên mà không cần mở từng nội dung gửi.

Lưu ý rằng phương pháp này cũng cho phép phương pháp không đồng bộ để chấm điểm đồng bộ hoá. Bạn có thể định kỳ thăm dò ý kiến của AddOnAttachmentStudentSubmission điểm cuối để phát hiện thời điểm học viên đã nộp bài tập. Thời điểm đã gửi, đặt điểm của bài tập bằng cách sử dụng thông tin đăng nhập đã lưu trữ.

Nếu bạn không muốn tải thông tin đăng nhập của giáo viên trong một phiên học của học viên, bạn có thể sử dụng thông tin đăng nhập của giáo viên đang hoạt động khi họ tải bài nộp trong iframe để đánh giá bài tập của học viên. Tuy nhiên, việc này có thể không đảm bảo rằng trải nghiệm người dùng cực kỳ mượt mà dưới dạng điểm số trong giao diện người dùng Lớp học không được cập nhật theo thời gian thực và giáo viên sẽ phải mở từng iframe của bài tập mà học viên đã nộp.

Phát hiện những thay đổi về điểm của bài tập

giáo viên có thể chỉnh sửa chế độ cài đặt điểm trong Lớp học sau khi bạn tạo bài tập. Các nội dung chỉnh sửa này có thể bao gồm:

Thay đổi giá trị điểm đã chỉ định.
Thay đổi giá trị maxPoints của một bài tập.
Thay đổi việc có nên chấm điểm bài tập hay không.

Để xem chế độ cài đặt chấm điểm hiện tại của một bài tập, bạn nên gửi một yêu cầu GET đến điểm cuối courses.courseWork. Câu trả lời bao gồm giá trị maxPoints hiện tại. Bài tập chưa chấm điểm có giá trị rỗng hoặc không Giá trị maxPoints.

Nếu bạn đã trả điểm về Lớp học, hãy sử dụng Điểm cuối courses.courseWork.addOnAttachments.studentSubmissions cần tìm nạp hoặc thay đổi điểm của tệp đính kèm bằng tiện ích bổ sung. Giá trị điểm được đặt bằng cách sử dụng Trường pointsEarned. Hãy cân nhắc việc kiểm tra và cập nhật giá trị này (nếu cần) nếu sản phẩm của bạn cho phép giáo viên chỉnh sửa điểm số của học viên cho một của bạn.