Method: courses.studentGroups.patch

تعدّل هذه الطريقة حقلًا واحدًا أو أكثر في مجموعة طلاب.

تُرجع هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يكن المستخدم الذي يطلب الإذن مخوّلاً بتعديل مجموعة الطلاب المطلوبة أو في حال حدوث أخطاء في الوصول
  • ‫NOT_FOUND إذا كانت مجموعة الطلاب غير متوفرة أو إذا لم يكن لدى المستخدم إذن الوصول إليها
  • ‫INVALID_ARGUMENT إذا تم تحديد حقول غير صالحة في قناع التعديل أو إذا لم يتم توفير قناع تعديل

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{id}

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
courseId

string

الحقل مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية.
id

string

الحقل مطلوب. معرّف مجموعة الطلاب.

مَعلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

الحقل مطلوب. قناع يحدّد الحقول التي سيتم تعديلها في مجموعة الطلاب هذا الحقل مطلوب لإجراء تحديث. يتعذّر التعديل في حال تحديد حقول غير صالحة.

يمكن للمعلّمين تحديد الحقول التالية:

  • title

هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

اختياريّ. إصدار معاينة نقطة النهاية. يجب ضبط هذا الإعداد للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة التي أتحناها للمطوّرين في "برنامج الإصدار التجريبي".

نص الطلب

يحتوي نص الطلب على مثال StudentGroup.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال StudentGroup.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.rosters

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.