Method: userProfiles.guardians.delete

Xoá người giám hộ.

Người giám hộ sẽ không còn nhận được thông báo dành cho người giám hộ và không thể truy cập được thông qua API nữa.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu người dùng yêu cầu không thấy người dùng nào khớp với studentId đã cung cấp, nếu người dùng yêu cầu không được phép quản lý người giám hộ cho học viên được xác định bằng studentId, nếu người giám hộ không được bật cho miền có liên quan hoặc đối với các lỗi truy cập khác.
  • INVALID_ARGUMENT nếu bạn chỉ định studentId nhưng không nhận dạng được định dạng của studentId (đây không phải là địa chỉ email cũng không phải là studentId từ API).
  • NOT_FOUND nếu người dùng yêu cầu được phép sửa đổi người giám hộ cho studentId được yêu cầu, nhưng không có bản ghi Guardian nào tồn tại cho học viên đó với guardianId đã cung cấp.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
studentId

string

Học viên có người giám hộ cần xoá. Một trong số sau:

  • giá trị nhận dạng dạng số của người dùng
  • địa chỉ email của người dùng
  • chuỗi cố định "me", cho biết người dùng yêu cầu
guardianId

string

Trường id từ Guardian.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.