Method: userProfiles.guardians.delete

حذف وصي

لن يتلقّى الوصي بعد ذلك إشعارات الوصي ولن تتمكّن من الوصول إليه عبر واجهة برمجة التطبيقات.

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

  • PERMISSION_DENIED إذا لم يكن أي مستخدم يتطابق مع studentId المقدَّم مرئيًا للمستخدم الذي قدّم الطلب، أو إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإدارة الأوصياء على الطالب الذي تم تحديده من خلال studentId، أو في حال عدم تفعيل الأوصياء للنطاق المعنيّ، أو بسبب أخطاء أخرى في الوصول.
  • INVALID_ARGUMENT إذا تم تحديد studentId، ولكن لا يمكن التعرّف على تنسيقه (ليس عنوان بريد إلكتروني أو studentId من واجهة برمجة التطبيقات).
  • NOT_FOUND إذا كان مسموحًا للمستخدم الذي قدّم الطلب بتعديل الأوصياء في studentId المطلوب، ولكن لا يتوفّر سجلّ Guardian لهذا الطالب مع guardianId المقدَّم.

طلب HTTP

DELETE https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}

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

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

المَعلمات
studentId

string

الطالب الذي سيتم حذف الوصي عليه. يجب استخدام إحدى السمات التالية:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • القيمة الحرفية للسلسلة "me"، ما يشير إلى المستخدم الذي قدّم الطلب
guardianId

string

الحقل id من Guardian.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.

نطاقات التفويض

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

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

لمزيد من المعلومات، راجِع دليل التفويض.