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 będą 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 za pomocą identyfikatora klienta OAuth użytego do utworzenia zadania z pracy domowej nadrzędnego.

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 ocena została już wystawiona na podstawie kryteriów.
  • INVALID_ARGUMENT jeśli żądanie jest źle sformatowane, oraz w przypadku tych błędów żądania:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND jeśli żądany kurs, praca domowa lub karta nie istnieją lub jeśli użytkownik nie ma dostępu do odpowiedniej pracy domowej.
  • 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 karcie należy zaktualizować. To pole jest wymagane do wprowadzenia 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 listy criteria. Do zdefiniowania kryteriów można użyć tylko jednego z nich naraz.

Lista kryteriów oceny criteria zostanie całkowicie zastąpiona kryteriami oceny 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 to zrobić.

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.