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

เนื้อหาของคำขอ

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

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

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

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

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

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

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