요청 객체에는 studentId 및 invitedEmailAddress 필드가 설정되어 있어야 합니다. 이러한 필드를 설정하지 못하거나 요청에서 다른 필드를 설정하면 오류가 발생합니다.
이 메서드는 다음 오류 코드를 반환합니다.
PERMISSION_DENIED: 현재 사용자에게 보호자 관리 권한이 없거나, 해당 보호자가 이미 해당 학생에 대한 너무 많은 요청을 거부한 경우, 해당 도메인에 보호자가 사용 설정되지 않은 경우 또는 기타 액세스 오류가 있는 경우
RESOURCE_EXHAUSTED: 학생 또는 보호자가 보호자 링크 한도를 초과한 경우
보호자 이메일 주소가 유효하지 않은 경우 (예: 너무 긴 경우) 또는 제공된 학생 ID의 형식을 인식할 수 없는 경우 (예: 이메일 주소 또는 이 API의 userId도 아님) INVALID_ARGUMENT입니다. 이 오류는 읽기 전용 필드가 설정되었거나 state 필드가 PENDING 이외의 값으로 설정된 경우에도 반환됩니다.
제공된 학생 ID가 유효한 학생 ID이지만 클래스룸에 해당 학생의 기록이 없는 경우 NOT_FOUND
학생과 invitedEmailAddress이(가) 이미 대기 중인 보호자 초대가 있거나 입력한 invitedEmailAddress이(가) 이 사용자의 기존 Guardian의 Google 계정과 일치하는 경우 ALREADY_EXISTS입니다.
HTTP 요청
POST https://classroom.googleapis.com/v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations