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ể xây dựng gì bằng điểm cuối của Khoá học trong API Lớp học?

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

  • Xem bài tập và câu hỏi (gọi chung là CourseWork) cho 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 nộp bài của học viên (chẳng hạn như nộp bài, trả bài, xác nhận lại quyền sở hữu)
  • Đặ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 làm học viên nộp

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

  • Sổ điểm, SIS hoặc cá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 cho các ứng dụng của họ, loại bỏ dữ liệu thủ công chuyển
  • Các ứng dụng học tập có thể tạo bài tập mới và xuất hiện trong lớp học luồng. Khi học sinh hoàn thành bài tập, các ứng dụng có thể nộp bài tập, đặt chấm điểm, đính kèm bài tập của học viên và lưu trữ bài tập cho phù hợp Thư mục trên Drive.
  • Người dùng là giáo viên có thể tạo bài tập bằng tiện ích bổ sung đính kèm từ 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ó tiện ích bổ sung của bạn tệp đính kèm.

Ứng dụng của tôi cần những quyền nào để tạo hoặc sửa đổi thông tin chỉ định?

Thông thường, ứ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 đột biến chỉ định phải sử dụng cùng một mã dự án Google Cloud được lưu trữ tại thời điểm tạo bài tập.

Quy tắc này không áp dụng cho các tiện ích bổ sung của Google Lớp học. Đáp 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 bằng tiện ích bổ sung. Đáp Dự án trên đám mây cũng có thể nộp, lấy lại hoặc trả bài tập có một hoặc nhiều tệp đính kèm bằng tiện ích bổ sung.

Các yêu cầu API cũng đòi hỏi phải 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 đến bài tập đã nộp và thiết lập điểm bài nộp. Học viên có thể xem bài tập và đính kèm đường liên kết vào bài tập hồ sơ bài tập cũng như nộp bài và xác nhận lại bài tập đã nộp. Tên miền quản trị viên có thể xem CourseWork nhưng không có quyền ghi.

Đơn đăng ký 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 nộp?

API này hỗ trợ đính kèm tệp trên Drive, video trên YouTube và . Tính năng đính kèm Google Biểu mẫu gốc chưa được hỗ trợ.

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

Có. Giao diện người dùng của Lớp học xác định các bài tập được tạo bên ngoài bằng tên sản phẩm của dự án trên Google Cloud đã tạo tác phẩm đó. 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 ra tác phẩm đó bằng cách thu hồi mọi thông tin xác thực được cấp cho ứng dụng của người dùng.

Nút chia sẻ 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ẻ 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 Google Cloud dự án đã 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. Trả lời câu hỏi có lập trình là một lộ trình của chúng tô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 riêng tư trên Google Cloud mà tôi đã sử 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 khi phát hành công khai không?

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

Một dự á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 hai trang thông tin trên Google Workspace Marketplace cho một dự án duy nhất trong Google Cloud.

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

Tôi có thể sử 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 các tiện ích bổ sung của Lớp học không?

Không, ứng dụng OAuth của một dự án Google Cloud khác với Dự án Google Cloud của tiện ích bổ sung dành cho Lớp học không thể hoạt động. Mã truy cập do một dự án khác trên Google Cloud tạo sẽ bị API Lớp học từ chối. Bạn phải tạo một ứng dụng OAuth riêng biệt 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 vừa với hình vuông nhỏ, có những kích thước nào cho biểu trưng trong thanh tiêu đề iframe?

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

Miền

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

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

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

Quản trị viên miền (Quản trị viên) kiểm soát ai có thể sử dụng tiện ích bổ sung của bạn. Chúng có thể cài đặt tiện ích bổ sung cho toàn bộ miền bằng cách sử dụng cài đặt của quản trị viên . Nếu bạn có thể cài đặt riêng tiện ích bổ sung, xin lưu ý rằng hầu hết Quản trị viên có một danh sách cho phép sử dụng tiện ích bổ sung; giáo viên có thể cài đặt tiện ích bổ sung cho có tên trong danh sách này. 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 thử nghiệm.

Quản trị viên cũng có thể quan tâm đến số liệu thống kê sử dụng liên quan đến tiện ích bổ sung. 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 dành cho quản trị viên trên trang web của bạn.

API

Đâu là cách đáng tin cậy để biết liệu trang đối tác được tải bên trong iframe hay thẻ bật ra?

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

Mục bài tập có thể giao nào sẽ nhận được iframe Đánh giá bài tập của học viên?

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

Tiện ích bổ sung đính kèm có thể truy cập vào mục phát trực tuyến mà tệp đính kèm không?

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

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

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

Có phải mỗi học viên đều sở hữu địa chỉ email có định dạng phù hợp ngay cả khi không có quyền truy cập vào Gmail không?

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 được thể hiện bằng email của bạn. 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 Gmail) đều khác biệt. Vì vậy, ngay cả khi Gmail bị tắt, người dùng là học sinh vẫn có thể đăng nhập bằng địa chỉ email của họ.

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

Trước khi có thể cài đặt tiện ích bổ sung, quản trị viên miền phải đưa vào danh sách cho phép. Nếu muốn, quản trị viên miền có thể cài đặt tiện ích bổ sung cho tất cả người dùng trong 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 vấn đề về yêu cầu?

Bạn có thể gửi, xem và bỏ phiếu cho các yêu cầu về tính năng trong số phát hành công khai của chúng tôi công cụ theo dõ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?

Thông tin cập nhật về API này được đăng trên trang ghi chú phát hành, diễn đàn dành cho nhà phát triển của chúng tôi 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 kỹ thuật?

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