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

Xem, tạo và sửa đổi CourseWork trong Lớp học

Tôi có thể tạo gì bằng điểm cuối CourseWork 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 học. Cụ thể, bạn có thể thực hiện tất cả các thao tác sau:

  • Xem bài tập và câu hỏi (gọi chung là "courseWork") dành cho người dùng
  • Tạo, sửa đổi và xoá Khoá học
  • Đính kèm tài liệu (tệp trên Drive, video trên YouTube, đường liên kết) vàoCourseWork
  • Thay đổi trạng thái bài tập mà học viên nộp (chẳng hạn như nộp, trả bài, xác nhận lại bài)
  • Đặt điểm cho một 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 của học viên

Một số trường hợp sử dụng mẫu của 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, giúp loại bỏ việc chuyển dữ liệu 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 Drive thích hợp.
  • Người dùng là giáo viên có thể tạo bài tập bằng cá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 của tiện ích bổ sung.

Ứng dụng của tôi cần 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 tác vụ mà ứng dụng tạo ra. Nói cách khác, mọi yêu cầu API thay đổi chỉ định đều 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 chỉ định.

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

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 đến bài tập đã nộp và đặt điểm của bài 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 bài và thu hồ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.

Đơ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à đường liên kết. Chưa hỗ trợ đính kèm biểu mẫu Google Biểu mẫu gốc.

Người dùng cuối có biết rằng một bài tập trong Lớp học là do ứng dụng của tôi tạo ra 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 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 tác vụ đượ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 tác vụ đó, 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ẻ 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 đã tạo bằng nút chia sẻ không?

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

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

Chưa. Bạn có thể tạo và sửa đổi câu hỏi. Chúng tôi đã có tính năng trả lời câu hỏi theo phương thức lập trình.

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 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 trong bản 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 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 để phát hành chính thức.

Mỗi dự án trên Google Cloud có thể có hai trang thông tin GWM được không?

Không. Bạn không thể tạo hai trang thông tin về GWM cho một dự án trên Google Cloud.

Tuy nhiên, bạn vẫn có thể gói các tiện ích bổ sung. Cách làm này cho phép một trang thông tin GWM đại diện cho nhiều tiện ích bổ sung. Việc cài đặt qua một trang thông tin như vậy sẽ cài đặt tất cả tiện ích bổ sung trong gói cùng một lúc. Người dùng sẽ phải đồng ý với tất cả các phạm vi cần thiết của các tiện ích bổ sung đi kèm khi cho phép.

Có hai điều khác bạn cần cân nhắc liên quan đến việc gói:

  1. Tiện ích bổ sung dành cho Lớp học chỉ được cung cấp cho những người đăng ký Teaching & Learning Upgrade hoặc SKU Education Plus.

  2. API tiện ích bổ sung đang ở giai đoạn Quyền truy cập sớm và chỉ dành cho các nhà phát triển tham gia cũng như các dự án trên Google Cloud. Các tiện ích bổ sung theo gói có thể không hoạt động như mong đợi nếu dựa vào các dự án Google Cloud không tham gia.

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 tiện ích bổ sung cho Lớp học không?

Không, ứng dụng OAuth của một dự án Google Cloud không phải là dự án Google Cloud có tiện ích bổ sung dành cho Lớp học sẽ không thể hoạt động. Mã thông báo 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 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 trong một hình vuông nhỏ, có các tùy chọn 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 đưa ra để khớ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 hướng dẫn chúng tôi sử dụng cùng một biểu trưng để đả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 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 nào có thể xem tiện ích bổ sung đã cài đặt.

Quản trị viên miền tương tác với các 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 một tiện ích bổ sung cho toàn bộ miền bằng cách sử dụng tuỳ chọn 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 đều duy trì danh sách cho phép tiện ích bổ sung; giáo viên có thể cài đặt các tiện ích bổ sung có 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 kiểm thử.

Quản trị viên cũng có thể quan tâm đến số liệu thống kê về việ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 quản trị viên trên trang web của bạn.

API

Đâu là cách đáng tin cậy để biết trang đối tác được tải trong iframe hay thẻ cửa sổ mở rộng?

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

Những mục bài tập có thể giao nào sẽ có iframe Đánh giá bài tập của học viên?

iframe 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 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.

Có thể có những thay đổi có thể gây lỗi nào đối với API trong chương trình tiếp cận sớm không?

API tiện ích bổ sung vẫn đang trong quá trình phát triển. Do đó, có thể có các thay đổi có thể gây lỗi đối với API khiến các yêu cầu đã thành công trước đó bị lỗi hoặc hoạt động theo cách khác. Bạn có thể được thông báo trước về mọi thay đổi có thể gây lỗi thông qua diễn đàn dành cho nhà phát triển.

Tệp đính kèm của tiện ích bổ sung có thể truy cập vào mục luồng đượ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 trong các tệp đính kèm của tiện ích bổ sung. Bạn có thể reclaim, return hoặc turnIn một CourseWork StudentSubmission.

Khi nào các tiện ích bổ sung của Lớp học được phát hành công khai?

Tất cả người dùng cuối đều có thể sử dụng tiện ích bổ sung của Lớp học kể từ mùa hè năm 2022. API tiện ích bổ sung dự kiến sẽ được cung cấp rộng rãi cho các nhà phát triển vào khoảng năm 2024.

Đă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.

Liệu mọi học sinh đều có địa chỉ email được định dạng phù hợp, 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 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à khác 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 mình.

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 tiện ích bổ sung vào danh sách cho phép thì mới có thể cài đặt. Quản trị viên miền có thể tuỳ ý 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.

Ý 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 báo cáo vấn đề liên quan đến yêu cầu?

Bạn có thể gửi, xem và bình chọn 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 cho API đượ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 lên Stack Overflow bằng thẻ google-classroom.