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.
REST Resource: courses.topics
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Chủ đề
Chủ đề do giáo viên tạo cho khoá học
Biểu diễn dưới dạng JSON |
{
"courseId": string,
"topicId": string,
"name": string,
"updateTime": string
} |
Trường |
courseId |
string
Giá trị nhận dạng của khoá học. Chỉ đọc.
|
topicId |
string
Giá trị nhận dạng duy nhất của chủ đề. Chỉ đọc.
|
name |
string
Tên của chủ đề do người dùng tạo. Khoảng trắng ở đầu và ở cuối (nếu có) sẽ bị cắt bớt. Ngoài ra, nhiều khoảng trắng liên tiếp sẽ được thu gọn thành một khoảng trắng trong tên. Kết quả phải là một chuỗi không trống. Tên chủ đề có phân biệt chữ hoa chữ thường và không được dài quá 100 ký tự.
|
updateTime |
string (Timestamp format)
Thời gian hệ thống cập nhật chủ đề lần gần đây nhất. Chỉ đọc. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30" .
|
Phương thức |
|
Tạo một chủ đề. |
|
Xoá một chủ đề. |
|
Trả về một chủ đề. |
|
Trả về danh sách các chủ đề mà người yêu cầu được phép xem. |
|
Cập nhật một hoặc nhiều trường của một chủ đề. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-26 UTC."],[],[],null,["- [Resource: Topic](#Topic)\n - [JSON representation](#Topic.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Topic Topic created by a teacher for the course\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"topicId\": string, \"name\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. Read-only. |\n| `topicId` | `string` Unique identifier for the topic. Read-only. |\n| `name` | `string` The name of the topic, generated by the user. Leading and trailing whitespaces, if any, are trimmed. Also, multiple consecutive whitespaces are collapsed into one inside the name. The result must be a non-empty string. Topic names are case sensitive, and must be no longer than 100 characters. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The time the topic was last updated by the system. Read-only. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n| Methods ||\n|------------------------------------------------------------------------|---------------------------------------------------------------------|\n| [create](/workspace/classroom/reference/rest/v1/courses.topics/create) | Creates a topic. |\n| [delete](/workspace/classroom/reference/rest/v1/courses.topics/delete) | Deletes a topic. |\n| [get](/workspace/classroom/reference/rest/v1/courses.topics/get) | Returns a topic. |\n| [list](/workspace/classroom/reference/rest/v1/courses.topics/list) | Returns the list of topics that the requester is permitted to view. |\n| [patch](/workspace/classroom/reference/rest/v1/courses.topics/patch) | Updates one or more fields of a topic. |"]]