Method: courses.courseWork.rubrics.patch

Aktualizuje ocenę cząstkową.

Szczegółowe informacje o tym, które pola można aktualizować, znajdziesz na stronie google.classroom.v1.Rubric. Po rozpoczęciu oceniania możliwości aktualizacji ocen cząstkowych są ograniczone.

To żądanie musi zostać przesłane w konsoli Google Cloud identyfikatora klienta OAuth użytego do utworzenia elementu roboczego nadrzędnego kursu.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli projekt dewelopera, z którego wysłano prośbę, nie utworzył odpowiedniego zadania w ramach kursu, użytkownik nie może dokonać żądanej zmiany oceny cząstkowej lub z powodu błędów dostępu. Ten kod błędu jest też zwracany, jeśli ocena cząstkowa już się rozpoczęła.
  • INVALID_ARGUMENT, jeśli żądanie ma nieprawidłowy format i występuje ten błąd:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND, jeśli nie istnieje żądany kurs, zadanie lub ocena cząstkowa albo użytkownik nie ma dostępu do odpowiadających im zadań na zajęciach.
  • INTERNAL, jeśli ocenianie zostało już rozpoczęte w przypadku oceny cząstkowej.

Żądanie HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

To pole jest wymagane. Identyfikator zajęć.
courseWorkId

string

To pole jest wymagane. Identyfikator zadania.
id

string

Opcjonalnie. Identyfikator oceny cząstkowej.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Opcjonalnie. Maska określająca pola oceny cząstkowej, które mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Aktualizacja nie powiedzie się, jeśli podasz nieprawidłowe pola. Kryteria oceny cząstkowej można definiować na kilka sposobów: lista sourceSpreadsheetId i lista criteria. Jednocześnie można używać tylko jednego z tych elementów do definiowania oceny cząstkowej.

Lista ocen cząstkowych criteria została w pełni zastąpiona kryteriami oceny cząstkowej określonymi w prośbie o aktualizację. Jeśli w żądaniu brakuje na przykład kryterium lub poziomu, jest on usuwany. Dodano nowe kryteria i poziomy oraz przypisano identyfikator. Jeśli identyfikator jest określony w żądaniu, dotychczasowe kryteria i poziomy zachowują wcześniej przypisany identyfikator.

Nauczyciele mogą określać te pola:

  • criteria
  • sourceSpreadsheetId

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

enum (PreviewVersion)

Opcjonalnie. Wersja testowa interfejsu API. Ten parametr należy skonfigurować, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnianych deweloperom w ramach Programu testowania aktualizacji.

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

Więcej informacji znajdziesz w przewodniku po autoryzacji.