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

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