لإدارة الصفوف وقوائم الطلاب المسجّلين والدعوات في Google Classroom.
- مورد REST: v1.courses
- مورد REST: v1.courses.aliases
- مورد REST: v1.courses.announcements
- مورد REST: v1.courses.courseWork
- مرجع REST: v1.courses.courseWork.studentSubmissions
- مورد REST: v1.courses.courseWorkMaterials
- مورد REST: v1.courses.students
- مرجع REST: v1.courses.teachers
- مرجع REST: v1.courses.topics
- مورد REST: v1.invitations
- مورد REST: v1.registration
- مورد REST: v1.userProfiles
- مورد REST: v1.userProfiles.guardianInvite
- مورد REST: v1.userProfiles.guardians
الخدمة: 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 تعرض قائمة بالأوصياء التي يُسمح للمستخدم الذي اطّلع عليها بالاطّلاع على الطلب فقط. |