Method: courses.create

Tworzy kurs.

Użytkownik określony w parametrze ownerId jest właścicielem utworzonych zajęć i został dodany jako nauczyciel. Użytkownik bez uprawnień administratora może utworzyć kurs, którego będzie właścicielem. Administratorzy domeny mogą tworzyć zajęcia, których właścicielem jest dowolny użytkownik w domenie.

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

  • PERMISSION_DENIED jeśli użytkownik wysyłający żądanie nie ma uprawnień do tworzenia zajęć lub w przypadku błędów dostępu.
  • NOT_FOUND, jeśli nauczyciel główny nie jest prawidłowym użytkownikiem.
  • FAILED_PRECONDITION, jeśli konto właściciela kursu jest wyłączone lub w przypadku tych błędów żądania:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS, jeśli alias został określony w parametrze id i już istnieje.

Żądanie HTTP

POST https://classroom.googleapis.com/v1/courses

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja przedpremierowa interfejsu API. Musisz to ustawić, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach Programu testowania aktualizacji.

Treść żądania

Treść żądania zawiera wystąpienie elementu Course.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Course.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.courses

Więcej informacji znajdziesz w przewodniku po autoryzacji.