Method: courses.updateGradingPeriodSettings

Aktualizuje ustawienia okresu oceniania w kursie.

Za pomocą tej metody możesz dodawać, usuwać i modyfikować poszczególne okresy oceniania.

Użytkownik, który wysyła żądanie, i właściciel zajęć muszą mieć uprawnienia do modyfikowania okresów oceniania. Szczegółowe informacje znajdziesz w wymaganiach dotyczących licencjonowania.

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

  • PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do modyfikowania ustawień okresu oceniania w kursie lub w przypadku błędów dostępu:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • NOT_FOUND, jeśli żądany kurs nie istnieje.

Żądanie HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Wymagane. Identyfikator kursu.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola w GradingPeriodSettings mają zostać zaktualizowane.

Lista GradingPeriodSettings gradingPeriods zostanie całkowicie zastąpiona okresami oceniania określonymi w żądaniu aktualizacji. Na przykład:

  • Okresy oceny uwzględnione na liście bez identyfikatora są uważane za dodatki, a nowy identyfikator zostanie przypisany po przesłaniu prośby.
  • Okresy oceniania, które są obecnie dostępne, ale nie zostały uwzględnione w prośbie, zostaną uznane za usunięte.
  • Okresy oceny z dotychczasowym identyfikatorem i zmienionymi danymi są uznawane za zmiany. Niezmienione dane pozostaną bez zmian.
  • Okresy oceniania z nieznanym identyfikatorem spowodują błąd.

Możesz określić te pola:

  • gradingPeriods
  • applyToExistingCoursework

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja wstępna interfejsu API. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu w wersji podglądowej, musisz ustawić tę opcję.

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.