تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
ملاحظات الإصدار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحتوي هذه الصفحة على ملاحظات الإصدار الخاصة بـ Classroom API. يمكنك الاشتراك في قائمة الإشعارات لتلقّي إشعارات عبر البريد الإلكتروني.
13 نوفمبر 2023: معاينة المطوّر: إنشاء وتعديل وحذف نماذج التقييم
تتوفّر ميزة إنشاء وتعديل واسترداد وحذف نماذج التقييم كجزء من برنامج الإصدار التجريبي من Google Workspace للمطوّرين، الذي يتيح استخدام ميزات معيّنة قبل إطلاقها. تتيح هذه الميزة للمطوّرين إدارة نماذج التقييم في Classroom نيابةً عن المعلّمين. يمكنك الاطّلاع على
خريطة الطريق لمعرفة المزيد حول المشاركة في ميزات المعاينة.
26 يونيو 2023: تغيير في رمز الخطأ غير المؤثّر في وظائف "المستخدمين المدعوين"
تعرض نقاط النهاية التالية الآن الخطأ 404 للطلبات الواردة من المستخدمين المدعوين
(المعلّم أو الطالب الذي تمت دعوتهم إلى دورة تدريبية ولكنهم لم يقبلوا الدعوة بعد). في السابق، كانت نقاط النهاية هذه تعرض الخطأ 403:
courses.courseWork.createcourses.courseWork.deletecourses.courseWork.getcourses.courseWork.patchcourses.courseWorkMaterials.createcourses.courseWorkMaterials.deletecourses.courseWorkMaterials.getcourses.courseWorkMaterials.patchcourses.announcements.createcourses.announcements.deletecourses.announcements.getcourses.announcements.patch
نقاط النهاية ذات الصلة التالية غير متأثرة:
courses.courseWork.listcourses.courseWork.modifyAssigneescourses.courseWorkMaterials.listcourses.announcements.listcourses.announcements.modifyAssignees
8 أغسطس 2022: فئة العلامات وإعدادات دفتر العلامات
يمكن الآن استرداد فئة الدرجات للمهام الدراسية وإعدادات سجلّ الدرجات للدورات التدريبية باستخدام واجهة برمجة التطبيقات.
21 أيلول (سبتمبر) 2020: مواد Classroom
يمكن للمطوّرين الآن قراءة عناصر "مواد الواجب الدراسي" وكتابتها وتعديلها في Classroom:
2 أبريل 2019: المواضيع في Classroom
- استرداد وإنشاء وتعديل وحذف المواضيع في Classroom: يمكنك الآن تنظيم عناصر "الواجب الدراسي" واستردادها في Classroom من خلال واجهة برمجة التطبيقات.
7 آب (أغسطس) 2018: الإشعارات الفورية بشأن العمل الدراسي وعمليات التسليم من الطلاب
- تلقّي إشعارات في الوقت الفعلي بشأن التغييرات في أعمال الدورات التدريبية وعمليات تسليم الطلاب، ما يتيح لك الآن الاستماع إلى المهام الجديدة التي يتم نشرها، وعمليات تسليم الطلاب، وعمليات تصحيح المعلّمين، وغير ذلك
26 أيلول (سبتمبر) 2017: الإشعارات الفورية والإشعارات والمشاركات الفردية
- تلقّي إشعارات في الوقت الفعلي بشأن التغييرات في قوائم الطلاب: بدلاً من طلب البيانات من نقاط نهاية Classroom API لمعرفة التغييرات، يمكنك استخدام Google Cloud Pub/Sub لتلقّي آخر المعلومات عن قوائم الطلاب في صف أو نطاق
- إنشاء إشعارات وتعديلها: بالإضافة إلى الواجبات الدراسية، يمكن للتطبيقات الآن إنشاء إشعارات وتعديلها في ساحة مشاركات الصف
- إنشاء منشورات مخصّصة وتعديلها: يمكن للتطبيقات الآن نشر إشعارات أو واجبات دراسية لطلاب معيّنين، بدلاً من نشرها للصف بأكمله
1 أغسطس 2017: نقل ملكية الدورة التدريبية وسجلّ عمليات الإرسال
- تعديل المالك الأساسي للدورة التدريبية (ownerId) باستخدام بيانات اعتماد المشرف، أو بدء دعوة لمعلّم ليصبح مالك الدورة التدريبية
- الوصول إلى سجلّ عمليات الإرسال لعملية إرسال قام بها طالب
19 يونيو 2017: جدولة الواجبات والتقويم والمعلّمين الذين تم تأكيد هويتهم
تعديلات على Classroom API
11 يناير 2017: تعديلات على الواجبات الدراسية
تتيح التعديلات على نقاط نهاية المهام الدراسية للتطبيقات ما يلي:
- إنشاء الأسئلة وتعديلها
- تعديل الواجبات الدراسية وحذفها
- إضافة ملفات من Drive وفيديوهات من YouTube إلى المواد الدراسية وعمليات إرسال الطلاب
17 أغسطس 2016: الأوصياء في Classroom API
يُنشئ Google Classroom ملخّصات عن أنشطة الطلاب ويُرسلها إلى الأوصياء عبر البريد الإلكتروني. تتيح واجهة برمجة التطبيقات Classroom API استخدام الأوصياء. يمكن للمطوّرين إجراء ما يلي:
18 مايو 2016: إضافة "الواجبات الدراسية" إلى Classroom API
تتضمّن Classroom API الآن المقررات الدراسية، أي الواجبات والأسئلة وردود الطلاب والدرجات. يمكنك الاطّلاع على دليل "الواجبات الدراسية"
للبدء.
8 أغسطس 2015: Classroom API متاحة الآن للجميع
تتوفّر Classroom API الآن لجميع المطوّرين ونطاقات "G Suite للتعليم". لم يعُد عليك طلب إذن بالوصول لبدء استخدام واجهة برمجة التطبيقات.
29 حزيران (يونيو) 2015: إصدار تجريبي من Classroom API متاح الآن للمطوّرين
تتوفّر الآن معاينة للمطوّرين من Classroom API. يمكنك الاشتراك الآن
للحصول على إمكانية الوصول المبكر إلى الحسابات التجريبية.
للاطّلاع على الإعلان الكامل، يُرجى الانتقال إلى مدوّنة Google for Education.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Release Notes\n\nThis page contains release notes for the Classroom API. Subscribe to\nthe [announcement list](https://groups.google.com/forum/#!forum/classroom-dev-announce) to get email updates.\n\n#### 13 November 2023: **Developer Preview: Rubrics CRUD**\n\n[Rubrics CRUD](/workspace/classroom/rubrics) is available as part of the [Google Workspace Developer Preview\nProgram](/workspace/preview), which grants early access to certain features. This feature allows\ndevelopers to manage Classroom [rubrics](https://support.google.com/edu/classroom/answer/9335069?co=GENIE.Platform%3DDesktop) on behalf of teachers. See the\n[roadmap](/workspace/classroom/reference/roadmap) to learn more about participating in preview features.\n\n#### 26 June 2023: **Non-breaking error code change for Invited Users**\n\nThe following endpoints now return a 404 error for requests from Invited Users\n(a teacher or student that has been [invited](/workspace/classroom/guides/manage-invitations) to a course but has not yet\naccepted). Previously these endpoints returned a 403:\n\n- `courses.courseWork.create`\n- `courses.courseWork.delete`\n- `courses.courseWork.get`\n- `courses.courseWork.patch`\n- `courses.courseWorkMaterials.create`\n- `courses.courseWorkMaterials.delete`\n- `courses.courseWorkMaterials.get`\n- `courses.courseWorkMaterials.patch`\n- `courses.announcements.create`\n- `courses.announcements.delete`\n- `courses.announcements.get`\n- `courses.announcements.patch`\n\nThe following related endpoints are unaffected:\n\n- `courses.courseWork.list`\n- `courses.courseWork.modifyAssignees`\n- `courses.courseWorkMaterials.list`\n- `courses.announcements.list`\n- `courses.announcements.modifyAssignees`\n\n#### 8 August 2022: **Grade category and gradebook settings**\n\nIt is now possible to retrieve the [grade category](/workspace/classroom/reference/rest/v1/GradeCategory) for coursework and\n[gradebook settings](/workspace/classroom/reference/rest/v1/courses#gradebooksettings) for courses using the API.\n\n#### 21 September 2020: **Classroom Materials**\n\nDevelopers can now read, write, and modify CourseWork Material items in Classroom:\n\n- [Create CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/create)\n- Retrieve [one](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/get) or [all CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/list)\n- [Update CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/patch)\n- [Modify attachments for CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/modifyAttachments)\n- [Delete CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/delete)\n\n#### 18 November 2019: **New Share Button URL Parameters**\n\n- Set [share tag attributes](https://developers.google.com/workspace/classroom/guides/sharebutton#share_tag_attributes) for course ID and material type when sharing content to Classroom.\n\n#### 2 April 2019: **Topics in Classrooom**\n\n- [Retrieve](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/list), [create](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/create), [edit](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/patch), and [delete](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/delete) Topics in Classroom - now you can organize and retrieve Classwork items in Classroom through the API.\n\n#### 7 August 2018: **Push notifications for course work and student submissions**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of changes to course work and student submissions - now you can listen for new assignments being posted, students turning in their submissions, teachers grading submissions, and more\n\n#### 26 September 2017: **Push notifications, announcements, and individualized posts**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of roster changes - instead of polling Classroom API endpoints for changes, you can use [Google Cloud Pub/Sub](https://cloud.google.com/pubsub/) to get roster updates for a class or a domain\n- Create and update [announcements](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.announcements) - in addition to coursework, applications can now create and update announcements in the class stream\n- Create and update [individualized posts](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) - applications now have the option to post announcements or coursework to individual students, instead of the whole class\n\n#### 1 August 2017: **Transfer course ownership and submission history**\n\n- [Update](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) the primary owner of a course (ownerId) with admin credentials, or initiate an [invitation](https://developers.google.com/workspace/classroom/reference/rest/v1/invitations#courserole) for a teacher to become the course owner\n- Access [submission history](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions) for a student submission\n\n#### 19 June 2017: **Schedule coursework, calendar, and verified teachers**\n\nUpdates to the Classroom API\n\n- [Schedule coursework](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) to post at a later date/time by setting the scheduledTime field of coursework\n- Access the [calendarId](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) of a course\n- Identify if a given user is a [verified teacher](https://developers.google.com/workspace/classroom/reference/rest/v1/userProfiles)\n\n#### 11 January 2017: **Coursework updates**\n\nUpdates to the [coursework](https://developers.google.com/workspace/classroom/guides/manage-coursework) endpoints lets applications:\n\n- Create and update questions\n- Modify and delete coursework\n- Add Drive items and YouTube videos to coursework and student submissions\n\n#### 17 August 2016: **Guardians in the Classroom API**\n\nGoogle Classroom generates email summaries of student activities for guardians. The Classroom API has support for [guardians](https://developers.google.com/workspace/classroom/guides/manage-guardians). Developers can\n\n- Invite individuals to become guardians\n- Retrieve a student's invited and active guardians\n- Manage active guardians\n\n- G Suite for Education admins should confirm their\n [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings)\n are correct.\n\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 18 May 2016: **Coursework added to the Classroom API**\n\nThe Classroom API now includes coursework - the assignments, questions,\nstudent responses, and grades. See the [Coursework guide](/workspace/classroom/guides/manage-coursework)\nto get started.\n\n#### 08 August 2015: **Classroom API now generally available**\n\nThe Classroom API is now available to all developers and G Suite for\nEducation domains. You no longer need to request access to begin using the API.\n\n- G Suite for Education admins should confirm their [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings) are correct.\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 29 June 2015: **Classroom API now available developer preview**\n\nThe Classroom API is now available for developer preview. You can sign up now\nfor early [access and test accounts](/workspace/classroom/access).\n\n- ~~G Suite for Education admins who want to give users in their domain early\n access to the API can\n [sign up for the domains whitelist](//support.google.com/code/contact/classroom_api_admin_preview).~~\n- ~~Developers can\n [apply for early access](https://docs.google.com/a/google.com/forms/d/1hY4Lk3imYBSOanQHZSqw1AYt9AswVGiltV-Jp7_5QpI/viewform)\n to code with the API.~~\n\nFor the full announcement, see the\n[Google for Education blog](//googleforeducation.blogspot.com/2015/06/new-ways-to-integrate-with-Google-Classroom.html)."]]
