Tworzy zaproszenie. W danym momencie można mieć tylko jedno zaproszenie dla użytkownika i na kurs. Aby wprowadzić zmiany, usuń i utwórz ponownie zaproszenie.
Ta metoda zwraca następujące kody błędów:
PERMISSION_DENIED
, jeśli użytkownik wysyłający prośbę nie ma uprawnień do tworzenia zaproszeń na te zajęcia lub występuje błędy dostępu.NOT_FOUND
, jeśli kurs lub użytkownik nie istnieje.FAILED_PRECONDITION
:- jeśli konto żądanego użytkownika jest wyłączone.
- jeśli użytkownik ma już tę rolę lub rolę z większymi uprawnieniami.
- w przypadku tych błędów żądania:
- IneligibleOwner
ALREADY_EXISTS
, jeśli zaproszenie dla określonego użytkownika i zajęć już istnieje.
Żądanie HTTP
POST https://classroom.googleapis.com/v1/invitations
Adres URL używa składni transkodowania gRPC.
Treść żądania
Treść żądania zawiera wystąpienie elementu Invitation
.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Invitation
.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/classroom.rosters
Więcej informacji znajdziesz w przewodniku po autoryzacji.