Method: userProfiles.guardians.delete

ลบผู้ปกครอง

ผู้ดูแลจะไม่ได้รับข้อความแจ้งสำหรับผู้ดูแลอีกต่อไป และไม่สามารถเข้าถึงผู้ดูแลผ่าน API ได้อีกต่อไป

วิธีการนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ขอไม่เห็นผู้ใช้ที่ตรงกับ studentId ที่ระบุไว้ หากผู้ใช้ที่ขอไม่ได้รับอนุญาตให้จัดการผู้ปกครองของนักเรียนที่ระบุด้วย studentId หากไม่ได้เปิดใช้ผู้ปกครองสำหรับโดเมนที่เป็นปัญหา หรือหากเกิดข้อผิดพลาดในการเข้าถึงอื่นๆ
  • INVALID_ARGUMENT หากระบุ studentId แต่ระบบไม่รู้จักรูปแบบ (ไม่ใช่อีเมลหรือ studentId จาก API)
  • 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

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะเป็นออบเจ็กต์ JSON ว่าง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์