تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
REST Resource: courses.topics
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: الموضوع
موضوع أنشأه معلّم للدورة التدريبية
تمثيل JSON |
{
"courseId": string,
"topicId": string,
"name": string,
"updateTime": string
} |
الحقول |
courseId |
string
تمثّل هذه السمة معرّف الدورة التدريبية. للقراءة فقط.
|
topicId |
string
معرّف فريد للموضوع للقراءة فقط.
|
name |
string
اسم الموضوع الذي أنشأه المستخدم يتم قطع المسافات البيضاء البادئة واللاحقة، إن وُجدت. بالإضافة إلى ذلك، يتم دمج المسافات البيضاء المتعددة المتتالية في مسافة واحدة داخل الاسم. يجب أن تكون النتيجة سلسلة غير فارغة. أسماء المواضيع حساسة لحالة الأحرف، ويجب ألا يزيد طولها عن 100 حرف.
|
updateTime |
string (Timestamp format)
الوقت الذي تم فيه إجراء آخر تعديل على الموضوع من قِبل النظام للقراءة فقط. يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30" .
|
الطُرق |
|
تنشئ هذه الطريقة موضوعًا. |
|
لحذف موضوع |
|
تعرض هذه الدالة موضوعًا. |
|
تعرض هذه الطريقة قائمة بالمواضيع التي يُسمح لمقدّم الطلب بعرضها. |
|
تعدّل هذه الطريقة حقلًا واحدًا أو أكثر من حقول الموضوع. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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. |"]]