Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
Method: invitations.create
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:
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-09-04 UTC.
[null,null,["Ostatnia aktualizacja: 2024-09-04 UTC."],[[["Creates an invitation for a user to join a course, allowing only one active invitation per user and course at a time."],["Requires `https://www.googleapis.com/auth/classroom.rosters` authorization scope for successful execution."],["Returns an error if the user already has an invitation, the course or user doesn't exist, or the requesting user lacks permission."],["Uses an HTTP POST request to `https://classroom.googleapis.com/v1/invitations` with the invitation details in the request body."],["Upon successful creation, returns the newly created invitation details in the response body."]]],[]]
