Method: userProfiles.guardians.delete

보호자를 삭제합니다.

보호자는 더 이상 보호자 알림을 수신하지 않으며 API를 통해 보호자에게 더 이상 액세스할 수 없습니다.

이 메서드는 다음 오류 코드를 반환합니다.

  • 요청하는 사용자에게 제공된 studentId와 일치하는 사용자가 표시되지 않거나, 요청하는 사용자가 studentId로 식별된 학생의 보호자를 관리할 권한이 없거나, 해당 도메인에 보호자가 사용 설정되어 있지 않거나, 기타 액세스 오류가 있는 경우 PERMISSION_DENIED
  • studentId가 지정되었지만 형식을 인식할 수 없는 경우 (이메일 주소가 아니거나 API의 studentId가 아닌 경우) INVALID_ARGUMENT입니다.
  • 요청하는 사용자가 요청된 studentId의 보호자를 수정할 수 있지만 제공된 guardianId로 해당 학생에 대한 Guardian 레코드가 없는 경우 NOT_FOUND입니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
studentId

string

보호자를 삭제할 학생 다음 중 하나입니다.

  • 사용자의 숫자 식별자
  • 사용자의 이메일 주소
  • 요청하는 사용자를 나타내는 문자열 리터럴 "me"
guardianId

string

Guardian의 id 필드

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문은 빈 JSON 객체입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.