Method: invitations.create

Tworzy zaproszenie. Na jednego użytkownika i jedno szkolenie może przypadać tylko jedno zaproszenie. Aby wprowadzić zmiany, usuń zaproszenie i utwórz je ponownie.

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

  • PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do tworzenia zaproszeń na ten kurs lub jeśli wystąpiły błędy dostępu.
  • NOT_FOUND, jeśli szkolenie lub użytkownik nie istnieje.
  • FAILED_PRECONDITION:
    • jeśli konto użytkownika, którego dotyczy żądanie, jest wyłączone.
    • jeśli użytkownik ma już tę rolę lub rolę o większych uprawnieniach.
    • w przypadku tych błędów żądania:
      • IneligibleOwner
  • ALREADY_EXISTS, jeśli zaproszenie dla określonego użytkownika i kursu 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ę powiedzie, 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 dotyczącym autoryzacji.