Google Classroom API

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

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

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

مستند Discovery

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

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

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

  • https://classroom.googleapis.com

مورد REST: الإصدار 1.

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

مورد 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}
يتم عرض إعلان.
list GET /v1/courses/{courseId}/announcements
يعرض قائمة بالإعلانات التي يُسمح لمقدِّم الطلب بعرضها.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
يؤدي إلى تعديل وضع المُسند إليه وخياراته.
patch PATCH /v1/courses/{courseId}/announcements/{id}
لتعديل حقل واحد أو أكثر من الإشعارات.

مورد REST: v1.courses.courseWork

الطُرق
create POST /v1/courses/{courseId}/courseWork
إنشاء عمل الدورة التدريبية.
delete DELETE /v1/courses/{courseId}/courseWork/{id}
حذف عمل دورة تدريبية.
get GET /v1/courses/{courseId}/courseWork/{id}
يعرض عمل الدورة التدريبية.
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.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}
يعرض مادة عمل الدورة التدريبية.
list GET /v1/courses/{courseId}/courseWorkMaterials
يعرض قائمة بمواد العمل التي يُسمح لمقدِّم الطلب بعرضها.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
تعدّل حقلًا واحدًا أو أكثر من مواد عمل الدورة التدريبية.

مورد 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

الطُرق
get GET /v1/userProfiles/{userId}
يعرض ملفًا شخصيًا للمستخدم.

مورد REST: v1.userProfiles.guardianInvite

الطُرق
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
تعرض قائمة بالأوصياء التي يُسمح للمستخدم الذي اطّلع عليها بالاطّلاع على الطلب فقط.