Method: courses.courseWork.rubrics.patch

• Żądanie HTTP
• Parametry ścieżki
• Parametry zapytania
• Treść żądania
• Treść odpowiedzi
• Zakresy autoryzacji

Wersja przedpremierowa dla programistów: dostępna w ramach Programu podglądu dla programistów Google Workspace, który zapewnia wcześniejszy dostęp do niektórych funkcji. Ta funkcja jest dostępna w wersji V1_20231110_PREVIEW i nowszych. Więcej informacji znajdziesz w artykule Dostęp do interfejsów API podglądu dostępu.

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
Ważne: utworzenie oceny cząstkowej z arkusza Google przez określenie wartości sourceSpreadsheetId wymaga dodatkowych zakresów: https://www.googleapis.com/auth/spreadsheets.readonly lub https://www.googleapis.com/auth/spreadsheets. Pamiętaj, że zakresy spreadsheets są uznawane za wrażliwe i mogą wymagać zweryfikowania aplikacji.

Więcej informacji znajdziesz w przewodniku po autoryzacji.