Method: courses.courseWork.rubrics.patch

aktualizować oceny cząstkowej.

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

Użytkownik wysyłający prośbę i właściciel kursu muszą mieć możliwość tworzenia kryteriów. Szczegółowe informacje znajdziesz w wymaganiach dotyczących licencjonowania.

Żądanie musi zostać wysłane z konsoli Google Cloud identyfikatora klienta OAuth użytego do utworzenia elementu pracy nad kursem nadrzędnym.

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

  • PERMISSION_DENIED jeśli projekt dewelopera, który wysłał prośbę, nie utworzył odpowiedniej pracy zaliczeniowej, jeśli użytkownik nie ma uprawnień do wprowadzenia żądanej modyfikacji w karcie lub z powodu błędów dostępu. Ten kod błędu jest też zwracany, jeśli ocenianie według kryteriów zostało już rozpoczęte.
  • INVALID_ARGUMENT jeśli żądanie jest źle sformatowane, oraz w przypadku tych błędów żądania:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND jeśli żądany kurs, praca zaliczeniowa lub schemat oceniania nie istnieje albo użytkownik nie ma dostępu do odpowiedniej pracy zaliczeniowej.
  • INTERNAL jeśli ocena została już rozpoczęta na podstawie tej karty.

Żą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

Wymagane. Identyfikator kursu.
courseWorkId

string

Wymagane. Identyfikator zadania.
id

string

Opcjonalnie: Identyfikator rubryki.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Opcjonalnie: Maska, która określa, które pola w recenzji mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Kryteria kryteriów oceniania można definiować na kilka sposobów: za pomocą listy sourceSpreadsheetId lub criteria. Do zdefiniowania kryteriów można użyć tylko jednego z nich naraz.

Lista kryteriów kryteriów criteria zostanie całkowicie zastąpiona kryteriami określonymi w żądaniu aktualizacji. Jeśli na przykład w prośbie brakuje kryterium lub poziomu, jest ona usuwana. Dodawane są nowe kryteria i poziomy oraz przypisywany jest identyfikator. Istniejące kryteria i poziomy zachowują wcześniej przypisany identyfikator, jeśli jest on określony w żądaniu.

Nauczyciele mogą określić te pola:

  • criteria
  • sourceSpreadsheetId

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 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 dotyczącym autoryzacji.