Method: courses.update

Aktualizuje kurs.

Uwaga: w przeciwieństwie do innych pól, jeśli pole levels zostanie pominięte w żądaniu, nie zostanie wyczyszczone. Metoda courses.update modyfikuje pole levels tylko wtedy, gdy jest ono wyraźnie podane. W przeciwnym razie zachowuje dotychczasową wartość. Aby wyczyścić pole levels, użyj metody courses.patch.

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

  • PERMISSION_DENIED, jeśli użytkownik wysyłający żądanie nie ma uprawnień do modyfikowania żądanego kursu lub jeśli występują błędy dostępu.
  • NOT_FOUND, jeśli nie ma kursu o podanym identyfikatorze.
  • FAILED_PRECONDITION w przypadku tych błędów żądania:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

Żądanie HTTP

PUT https://classroom.googleapis.com/v1/courses/{id}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
id

string

Identyfikator kursu do zaktualizowania. Ten identyfikator może być identyfikatorem przypisanym przez Classroom lub alias.

Parametry zapytania

Parametry
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja interfejsu API w wersji zapoznawczej. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach Programu testowania aktualizacji, musisz ustawić tę wartość.

Treść żądania

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Course.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku Autoryzacja.