Google Classroom API

يمكنك استخدامها في إدارة الصفوف وقوائم الطلاب المسجّلين والدعوات في Google Classroom.

• مورد REST: ‏ v1.courses
• مورد REST: ‏ v1.courses.aliases
• مورد REST: ‏ v1.courses.announcements
• مورد REST: ‏ v1.courses.announcements.addOnAttachments
• مورد REST: ‏ v1.courses.courseWork
• مورد REST: ‏ v1.courses.courseWork.addOnAttachments
• مورد REST: ‏ v1.courses.courseWork.addOnAttachments.studentSubmissions
• مورد REST: ‏ v1.courses.courseWork.rubrics
• مورد REST: ‏ v1.courses.courseWork.studentSubmissions
• مورد REST: ‏ v1.courses.courseWorkMaterials
• مورد REST: ‏ v1.courses.courseWorkMaterials.addOnAttachments
• مورد REST: ‏ v1.courses.posts
• مورد REST: ‏ v1.courses.posts.addOnAttachments
• مورد REST: ‏ v1.courses.posts.addOnAttachments.studentSubmissions
• مورد REST: ‏ v1.courses.students
• مورد REST: ‏ v1.courses.teachers
• مورد REST: ‏ v1.courses.topics
• مورد REST: ‏ v1.invitations
• مورد REST: ‏ v1.registrations
• مورد REST: ‏ v1.userProfiles
• مورد REST: ‏ v1.userProfiles.guardianInvitations
• مورد REST: ‏ v1.userProfiles.guardians

الخدمة: classroom.googleapis.com

للاتّصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.

المستند المرتبط بميزة "اقتراحات"

مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

• https://classroom.googleapis.com/$discovery/rest?version=v1

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

• https://classroom.googleapis.com

مورد REST: ‏ v1.courses

الطُرق
checkAddOnCreationEligibility (deprecated)	GET /v1/courses/{courseId}:checkAddOnCreationEligibility تعرِض هذه السمة ما إذا كان المستخدم مؤهَّلاً لإنشاء مرفقات إضافية في دورة تدريبية معيّنة.
checkGradingPeriodsSetupEligibility (deprecated)	GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility إصدار المطوّر التجريبي: يتوفّر كجزء من برنامج إصدار المطوّر التجريبي في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تتوفّر هذه الميزة في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات. تعرِض ما إذا كان المستخدم مؤهَّلاً لتعديل GradingPeriodSettings في دورة دراسية معيّنة.
create	POST /v1/courses لإنشاء دورة تدريبية
delete	DELETE /v1/courses/{id} لحذف دورة تدريبية.
get	GET /v1/courses/{id} لعرض دورة تدريبية.
getGradingPeriodSettings	GET /v1/courses/{courseId}/gradingPeriodSettings إصدار المطوّر التجريبي: يتوفّر كجزء من برنامج إصدار المطوّر التجريبي في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تتوفّر هذه الميزة في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات. تعرِض هذه السمة إعدادات فترة وضع الدرجات في دورة تدريبية.
list	GET /v1/courses تعرِض هذه السمة قائمة بالدورات التدريبية التي يُسمح للمستخدم الذي يقدّم الطلب بعرضها، مع الحصر على الدورات التي تتطابق مع الطلب.
patch	PATCH /v1/courses/{id} لتعديل حقل واحد أو أكثر في دورة تدريبية
update	PUT /v1/courses/{id} تعديل دورة تدريبية
updateGradingPeriodSettings	PATCH /v1/courses/{courseId}/gradingPeriodSettings إصدار المطوّر التجريبي: يتوفّر كجزء من برنامج إصدار المطوّر التجريبي في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تتوفّر هذه الميزة في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات. تعديل إعدادات فترة وضع الدرجات لدورة تدريبية

مورد REST: ‏ v1.courses.aliases

الطُرق
create	POST /v1/courses/{courseId}/aliases لإنشاء عنوان بريد إلكتروني بديل لدورة تدريبية
delete	DELETE /v1/courses/{courseId}/aliases/{alias} لحذف عنوان بديل لدورة تدريبية.
list	GET /v1/courses/{courseId}/aliases تعرِض هذه الدالة قائمة بالأسماء البديلة لدورة تدريبية.

مورد REST: ‏ v1.courses.announcements

الطُرق
create	POST /v1/courses/{courseId}/announcements لإنشاء إعلان.
delete	DELETE /v1/courses/{courseId}/announcements/{id} لحذف إعلان.
get	GET /v1/courses/{courseId}/announcements/{id} عرض إعلان
getAddOnContext	GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext للحصول على بيانات وصفية لإضافات Classroom في سياق مشاركة معيّنة
list	GET /v1/courses/{courseId}/announcements تعرِض هذه السمة قائمة بالإعلانات التي يُسمح لمقدّم الطلب بالاطّلاع عليها.
modifyAssignees	POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees لتعديل وضع المستخدم المخصّص وخيارات الإعلان.
patch	PATCH /v1/courses/{courseId}/announcements/{id} لتعديل حقل واحد أو أكثر من إعلان

مورد REST: ‏ v1.courses.announcements.addOnAttachments

الطُرق
create	POST /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments لإنشاء مرفق إضافة ضمن مشاركة.
delete	DELETE /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId} لحذف مرفق إضافة.
get	GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId} تعرِض هذه السمة مرفقًا إضافيًا.
list	GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments تعرِض هذه السمة جميع المرفقات التي أنشأتها إحدى الإضافات ضمن المشاركة.
patch	PATCH /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId} تعديل مرفق إضافة

مورد REST: ‏ v1.courses.courseWork

الطُرق
create	POST /v1/courses/{courseId}/courseWork لإنشاء عمل دورة تدريبية
delete	DELETE /v1/courses/{courseId}/courseWork/{id} لحذف عمل دورة تدريبية.
get	GET /v1/courses/{courseId}/courseWork/{id} لعرض مهام الدورة الدراسية.
getAddOnContext	GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext للحصول على بيانات وصفية لإضافات Classroom في سياق مشاركة معيّنة
list	GET /v1/courses/{courseId}/courseWork تعرِض هذه السمة قائمة بالأعمال الدراسية التي يُسمح لمقدّم الطلب بعرضها.
modifyAssignees	POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees لتعديل وضع المُسنَد إليه وخيارات مقرر دراسي.
patch	PATCH /v1/courses/{courseId}/courseWork/{id} يُعدِّل حقلًا واحدًا أو أكثر من عمل الدورة الدراسية.

مورد REST: ‏ v1.courses.courseWork.addOnAttachments

الطُرق
create	POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments لإنشاء مرفق إضافة ضمن مشاركة.
delete	DELETE /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId} لحذف مرفق إضافة.
get	GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId} تعرِض هذه السمة مرفقًا إضافيًا.
list	GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments تعرِض هذه السمة جميع المرفقات التي أنشأتها إحدى الإضافات ضمن المشاركة.
patch	PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId} تعديل مرفق إضافة

مورد REST: ‏ v1.courses.courseWork.addOnAttachments.studentSubmissions

الطُرق
get	GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId} تعرِض هذه السمة عملًا أرسله طالب لإضافة مرفق.
patch	PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId} لتعديل البيانات المرتبطة بإرسال مرفق إضافة.

مورد REST: ‏ v1.courses.courseWork.rubrics

الطُرق
create	POST /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics لإنشاء قواعد تقييم.
delete	DELETE /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id} لحذف قاعدة تقييم.
get	GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id} لعرض قاعدة تقييم.
list	GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics تعرِض هذه السمة قائمة بالفئات التي يُسمح لمقدّم الطلب بالاطّلاع عليها.
patch	PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id} لتعديل قاعدة تقييم

مورد REST: ‏ v1.courses.courseWork.studentSubmissions

الطُرق
get	GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id} عرض عمل الطالب
list	GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions تعرِض هذه الدالة قائمة بالمهام التي أرسلها الطلاب ويُسمح لمقدّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب.
modifyAttachments	POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments تعديل مرفقات العينة التي أرسلها الطالب
patch	PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id} تُعدِّل هذه الأداة حقلًا واحدًا أو أكثر من الإدخال الذي أرسله الطالب.
reclaim	POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim استرداد عمل أرسله طالب نيابةً عن الطالب مالك العمل
return	POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return عرض عمل الطالب
turnIn	POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn تسليم عمل الطالب

مورد REST: ‏ v1.courses.courseWorkMaterials

الطُرق
create	POST /v1/courses/{courseId}/courseWorkMaterials لإنشاء مادة عمل الدورة التدريبية.
delete	DELETE /v1/courses/{courseId}/courseWorkMaterials/{id} لحذف مادة عمل الدورة الدراسية.
get	GET /v1/courses/{courseId}/courseWorkMaterials/{id} تعرض مادة عمل الدورة التدريبية.
getAddOnContext	GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext للحصول على بيانات وصفية لإضافات Classroom في سياق مشاركة معيّنة
list	GET /v1/courses/{courseId}/courseWorkMaterials لعرض قائمة بمواد عمل الدورة التدريبية التي يُسمح لمقدّم الطلب بالاطّلاع عليها.
patch	PATCH /v1/courses/{courseId}/courseWorkMaterials/{id} لتعديل حقل واحد أو أكثر من مواد عمل الدورة الدراسية

مورد REST: ‏ v1.courses.courseWorkMaterials.addOnAttachments

الطُرق
create	POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments لإنشاء مرفق إضافة ضمن مشاركة.
delete	DELETE /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId} لحذف مرفق إضافة.
get	GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId} تعرِض هذه السمة مرفقًا إضافيًا.
list	GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments تعرِض هذه السمة جميع المرفقات التي أنشأتها إحدى الإضافات ضمن المشاركة.
patch	PATCH /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId} تعديل مرفق إضافة

مورد REST: ‏ v1.courses.posts

الطُرق
getAddOnContext	GET /v1/courses/{courseId}/posts/{postId}/addOnContext للحصول على بيانات وصفية لإضافات Classroom في سياق مشاركة معيّنة

مورد REST: ‏ v1.courses.posts.addOnAttachments

الطُرق
create	POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments لإنشاء مرفق إضافة ضمن مشاركة.
delete	DELETE /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId} لحذف مرفق إضافة.
get	GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId} تعرِض هذه السمة مرفقًا إضافيًا.
list	GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments تعرِض هذه السمة جميع المرفقات التي أنشأتها إحدى الإضافات ضمن المشاركة.
patch	PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId} تعديل مرفق إضافة

مورد REST: ‏ v1.courses.posts.addOnAttachments.studentSubmissions

الطُرق
get	GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId} تعرِض هذه السمة عملًا أرسله أحد الطلاب لمرفق إضافي.
patch	PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId} لتعديل البيانات المرتبطة بإرسال مرفق إضافة.

مورد REST: ‏ v1.courses.students

الطُرق
create	POST /v1/courses/{courseId}/students تُستخدَم هذه السمة لإضافة مستخدم كطالب في دورة تدريبية.
delete	DELETE /v1/courses/{courseId}/students/{userId} لحذف طالب من دورة تدريبية.
get	GET /v1/courses/{courseId}/students/{userId} لعرض طالب في دورة تدريبية.
list	GET /v1/courses/{courseId}/students تعرِض هذه السمة قائمة بطلاب هذه الدورة التدريبية المسموح لمقدّم الطلب بعرضها.

مورد REST: ‏ v1.courses.teachers

الطُرق
create	POST /v1/courses/{courseId}/teachers ينشئ معلّمًا لدورة تدريبية.
delete	DELETE /v1/courses/{courseId}/teachers/{userId} تؤدي هذه العملية إلى إزالة المعلّم المحدّد من الدورة التدريبية المحدّدة.
get	GET /v1/courses/{courseId}/teachers/{userId} لعرض معلّم دورة تدريبية.
list	GET /v1/courses/{courseId}/teachers تعرِض هذه السمة قائمة بمعلّمي هذه الدورة التدريبية المسموح لمقدّم الطلب بالاطّلاع عليها.

مورد REST: ‏ v1.courses.topics

الطُرق
create	POST /v1/courses/{courseId}/topics لإنشاء موضوع
delete	DELETE /v1/courses/{courseId}/topics/{id} لحذف موضوع.
get	GET /v1/courses/{courseId}/topics/{id} لعرض موضوع.
list	GET /v1/courses/{courseId}/topics تعرِض هذه السمة قائمة بالمواضيع التي يُسمح للمستخدِم بعرضها.
patch	PATCH /v1/courses/{courseId}/topics/{id} لتعديل حقل واحد أو أكثر من حقول موضوع معيّن

مورد REST: ‏ v1.invitations

الطُرق
accept	POST /v1/invitations/{id}:accept لقبول دعوة وإزالتها وإضافة المستخدم المدعو إلى المعلّمين أو الطلاب (حسب الاقتضاء) في الدورة الدراسية المحدّدة.
create	POST /v1/invitations لإنشاء دعوة.
delete	DELETE /v1/invitations/{id} لحذف دعوة
get	GET /v1/invitations/{id} عرض دعوة
list	GET /v1/invitations تعرِض هذه الدالة قائمة بالدعوات التي يُسمح للمستخدم الذي يطلبها بالاطّلاع عليها، ويقتصر ذلك على الدعوات التي تتطابق مع طلب القائمة.

مورد REST: ‏ v1.registrations

الطُرق
create	POST /v1/registrations يؤدي ذلك إلى إنشاء Registration، ما يؤدي إلى بدء Classroom في إرسال الإشعارات من feed المقدَّمة إلى الوجهة المقدَّمة في cloudPubSubTopic.
delete	DELETE /v1/registrations/{registrationId} يؤدي هذا الإجراء إلى حذف Registration، ما يؤدي إلى إيقاف Classroom لإرسال الإشعارات بشأن هذا Registration.

مورد REST: ‏ v1.userProfiles

الطُرق
checkUserCapability	GET /v1/userProfiles/{userId}:checkUserCapability إصدار المطوّر التجريبي: يتوفّر كجزء من برنامج إصدار المطوّر التجريبي في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تتوفّر هذه الميزة في الإصدار V1_20240930_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات. تعرِض هذه السمة ما إذا كان بإمكان المستخدم استخدام ميزة Classroom المحدّدة.
get	GET /v1/userProfiles/{userId} عرض ملف شخصي للمستخدم

مورد REST: ‏ v1.userProfiles.guardianInvitations

الطُرق
create	POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations يتم إنشاء دعوة للأوصياء، ويتم إرسال رسالة إلكترونية إليهم لتأكيد أنّهم الأوصياء على الطالب.
get	GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId} لعرض دعوة محددة للوصي.
list	GET /v1/userProfiles/{studentId}/guardianInvitations تعرِض هذه الدالة قائمة بدعوات الأوصياء التي يُسمح للمستخدم المُقدّم للطلب بعرضها، ويتم فلترتها حسب المَعلمات المقدَّمة.
patch	PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId} يُعدِّل دعوة وصي.

مورد REST: ‏ v1.userProfiles.guardians

الطُرق
delete	DELETE /v1/userProfiles/{studentId}/guardians/{guardianId} لحذف وصي.
get	GET /v1/userProfiles/{studentId}/guardians/{guardianId} لعرض وصي محدّد.
list	GET /v1/userProfiles/{studentId}/guardians تعرِض هذه السمة قائمة بالأوصياء المسموح للمستخدم المُقدّم للطلب بالاطّلاع عليها، مع الحصر على أولئك الذين يتطابقون مع الطلب.