Method: courses.updateGradingPeriodSettings

Aktualizuje ustawienia okresu oceniania zajęć.

Użytkownik i właściciel zajęć muszą mieć uprawnienia do modyfikowania okresów oceniania. Więcej informacji znajdziesz w wymaganiach dotyczących licencjonowania.

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

  • PERMISSION_DENIED, jeśli użytkownik, który wysłał prośbę, nie może zmieniać ustawień okresu oceniania na zajęciach lub w przypadku błędów dostępu:
      .
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli żądane szkolenie 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 zajęć.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska określająca, które pola w polu GradingPeriodSettings mają być aktualizowane.

Lista GradingPeriodSettings gradingPeriods zostanie w pełni zastąpiona okresami oceniania określonymi w prośbie o aktualizację. Na przykład:

  • Okresy oceniania uwzględnione na liście bez identyfikatora są uznawane za dodane. Po przesłaniu żądania zostaje przypisany nowy identyfikator.
  • Okresy oceniania, które obecnie istnieją, ale których nie ma w prośbie, zostaną uznane za usunięte.
  • Okresy oceniania z wykorzystaniem istniejącego identyfikatora i zmodyfikowanych danych są uznawane za zmiany. Niezmodyfikowane dane pozostaną bez zmian.
  • Okresy oceniania dołączone do nieznanego identyfikatora spowodują błąd.

Możesz określić te pola:

  • gradingPeriods
  • applyToExistingCoursework

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcjonalnie: Wersja testowa interfejsu API. Jest ono wymagane, aby można było korzystać z nowych funkcji interfejsu API udostępnianych deweloperom w programie testowania wersji przedpremierowej.

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 na temat autoryzacji.