요청 객체에 studentId 및 invitedEmailAddress 필드가 설정되어 있어야 합니다. 이러한 필드를 설정하지 않거나 요청에 다른 필드를 설정하면 오류가 발생합니다.
이 메서드는 다음 오류 코드를 반환합니다.
PERMISSION_DENIED: 현재 사용자에게 보호자를 관리할 권한이 없거나, 해당 보호자가 해당 학생에 대한 요청을 이미 너무 많이 거부했거나, 해당 도메인에 보호자가 사용 설정되어 있지 않거나, 기타 액세스 오류가 있는 경우
RESOURCE_EXHAUSTED: 학생 또는 보호자가 보호자 링크 한도를 초과한 경우
보호자 이메일 주소가 유효하지 않거나 (예: 너무 긴 경우) 제공된 학생 ID 형식을 인식할 수 없는 경우 (이메일 주소가 아니거나 이 API의 userId가 아닌 경우) INVALID_ARGUMENT입니다. 읽기 전용 필드가 설정되거나 state 필드가 PENDING이 아닌 값으로 설정된 경우에도 이 오류가 반환됩니다.
NOT_FOUND: 제공된 학생 ID가 유효한 학생 ID이지만 클래스룸에 해당 학생의 기록이 없는 경우
ALREADY_EXISTS: 학생에 대한 보호자 초대가 이미 대기 중이고 제공된 invitedEmailAddress가 있거나 제공된 invitedEmailAddress가 이 사용자의 기존 Guardian의 Google 계정과 일치하는 경우
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-12-05(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."]]],[]]
