Method: userProfiles.guardianInvitations.create

Tworzy zaproszenie dla opiekuna i wysyła do niego e-maila z prośbą o potwierdzenie, że jest on opiekunem ucznia.

Gdy opiekun zaakceptuje zaproszenie, jego state zmieni się na COMPLETED, a on sam zacznie otrzymywać powiadomienia. Utworzony zostanie też zasób Guardian, który będzie reprezentować aktywnego opiekuna.

Obiekt żądania musi zawierać ustawione pola studentId i invitedEmailAddress. Nieustawienie tych pól lub ustawienie innych pól w żądaniu spowoduje błąd.

Ta metoda zwraca te kody błędów:

• PERMISSION_DENIED jeśli bieżący użytkownik nie ma uprawnień do zarządzania opiekunami, jeśli dany opiekun odrzucił już zbyt wiele próśb o dostęp dla tego ucznia, jeśli opiekunowie nie są włączeni w przypadku danej domeny lub z innych powodów związanych z błędami dostępu.
• RESOURCE_EXHAUSTED jeśli uczeń lub opiekun przekroczył limit połączeń z opiekunem.
• INVALID_ARGUMENT jeśli adres e-mail opiekuna jest nieprawidłowy (na przykład zbyt długi) lub jeśli nie można rozpoznać formatu podanego identyfikatora ucznia (nie jest to adres e-mail ani userId z tego interfejsu API). Ten błąd będzie też zwracany, jeśli pola tylko do odczytu są ustawione lub jeśli pole state ma wartość inną niż PENDING.
• NOT_FOUND jeśli podany identyfikator ucznia jest prawidłowy, ale Classroom nie ma informacji o tym uczniu.
• ALREADY_EXISTS jeśli dla ucznia i adresu invitedEmailAddress istnieje już oczekujące zaproszenie dla opiekuna lub jeśli podany adres invitedEmailAddress pasuje do istniejącego konta Google Guardian tego użytkownika.