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

Xem, tạo và sửa đổi Bài tậ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 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ả những việ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 của bài nộp của học viên (chẳng hạn như đã nộp, đã trả lại, lấy lạ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 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 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 sang các ứng dụng, nhờ đó loại bỏ việc chuyển dữ liệu theo cách thủ công
  • Ứ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, ứ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 Drive thích hợp.
  • 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 học viên có thể nộp bài tập có tệp đính kèm tiện ích bổ sung của bạn.

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

Tiện ích bổ sung dành cho Google Lớp học là 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 bất kỳ thông báo, bài tập hoặc tài liệu nào có một hoặc nhiều tệp đính kèm tiện ích bổ sung. Một dự án trên Google Cloud 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 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à đặ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à nhận 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 nộp?

API này hỗ trợ đính kèm tệp trên Drive, video trên YouTube và đường liên kết. 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 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 cách sử dụ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 do bên ngoài tạo 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 xác thực do 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 đã 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ể sử dụng trong môi trường 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 có hai dự án riêng biệt, một dự án để phát triển và một dự án để phát hành công khai.

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

Tuy nhiên, bạn có thể gói các tiện ích bổ sung. Việ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 qua một trang thông tin như vậy sẽ đồng thời cài đặt tất cả tiện ích bổ sung trong gói. Người dùng sẽ cần đồng ý với tất cả các phạm vi mà các tiện ích bổ sung đi kèm cần đến khi uỷ quyền.

Có thể sử dụng lại ứng dụng OAuth từ một dự án Google Cloud khác với 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 từ một dự án trên Google Cloud khác với dự án Google Cloud của tiện ích bổ sung của Google Lớp học sẽ không hoạt động. Mã truy cập do một dự án Google Cloud khác tạo sẽ bị API Lớp học từ chối. Bạn phải tạo một ứng dụng khách 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 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. Lựa chọn này được thực hiện để phù hợp với hình dạng favicon mà các công ty sử dụng trên trang web của họ. Chúng tôi cũng hướng dẫn bạn sử dụng cùng một biểu trưng trong không gian để đả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 trường học có thể kiểm soát những giáo viên có thể xem một 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 các tiện ích bổ sung của 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 (Quản trị viê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 tiện ích bổ sung cho toàn bộ miền bằng tuỳ chọn cài đặt dành cho 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 đều có danh sách cho phép đối với tiện ích bổ sung; giáo viên có thể tự cài đặt các tiện ích bổ sung thuộc danh sách này. Quản trị viên cũng có thể chọn cài đặt từng tiện ích bổ sung 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ề mức sử dụng tiện ích bổ sung trong chế độ xem quản trị viên trên trang web của riêng bạn.

API

Làm cách nào để biết trang của đối tác được tải bên trong iframe hay thẻ bật lên một cách đáng tin cậy?

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

Những mục bài tập có thể giao nào sẽ có khung hiển thị nội dung nhúng Bài tập của học viên?

Khung hiển thị nội dung nhúng Bài đánh giá 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 để biết liệu 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à 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ỳ Announcement, CourseWork hoặc CourseWorkMaterial nào chứa ít nhất một trong các tệp đính kèm của tiện ích bổ sung. Bạn có thể reclaim, return hoặc turnIn 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.

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ó 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 biểu thị bằng một địa chỉ email. 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) là riêng biệt. Vì vậy, ngay cả khi Gmail bị tắt, người dùng là học viên 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?

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ì mới có thể cài đặt tiện ích bổ sung đó. 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 miền hoặc một đơn vị tổ chức (không bắt buộ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 khắc phục 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?

Các bản cập nhật API được đăng trên trang ghi chú phát hành, diễn đàn 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 bằng thẻ google-classroom.