요청 객체에는 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
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-09-04(UTC)"],[[["Creates a guardian invitation and sends an email to the invited email address for confirmation to become a student's guardian."],["Requires the `studentId` and `invitedEmailAddress` in the request body to create the invitation."],["Returns a `GuardianInvitation` object upon successful creation, containing the invitation details."],["Several error codes are possible, such as `PERMISSION_DENIED`, `RESOURCE_EXHAUSTED`, `INVALID_ARGUMENT`, `NOT_FOUND`, and `ALREADY_EXISTS`, indicating various issues with the request or student/guardian status."],["Utilizes the `https://www.googleapis.com/auth/classroom.guardianlinks.students` OAuth scope for authorization."]]],[]]