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.
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".
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.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["# Method: courses.courseWork.rubrics.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a rubric.\n\nSee [google.classroom.v1.Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric) for details of which fields can be updated. Rubric update capabilities are [limited](/classroom/rubrics/limitations) once grading has started.\n\nThe requesting user and course owner must have rubrics creation capabilities. For details, see [licensing requirements](https://developers.google.com/workspace/classroom/rubrics/limitations#license-requirements).\n\nThis request must be made by the Google Cloud console of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the parent course work item.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting developer project didn't create the corresponding course work, if the user isn't permitted to make the requested modification to the rubric, or for [access errors](/workspace/classroom/reference/Access.Errors). This error code is also returned if grading has already started on the rubric.\n- `INVALID_ARGUMENT` if the request is malformed and for the following [request error](/workspace/classroom/reference/Request.Errors):\n - `RubricCriteriaInvalidFormat`\n- `NOT_FOUND` if the requested course, course work, or rubric doesn't exist or if the user doesn't have access to the corresponding course work.\n- `INTERNAL` if grading has already started on the rubric.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `courseWorkId` | `string` Required. Identifier of the course work. |\n| `id` | `string` Optional. Identifier of the rubric. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Optional. Mask that identifies which fields on the rubric to update. This field is required to do an update. The update fails if invalid fields are specified. There are multiple options to define the criteria of a rubric: the `sourceSpreadsheetId` and the `criteria` list. Only one of these can be used at a time to define a rubric. The rubric `criteria` list is fully replaced by the rubric criteria specified in the update request. For example, if a criterion or level is missing from the request, it is deleted. New criteria and levels are added and an ID is assigned. Existing criteria and levels retain the previously assigned ID if the ID is specified in the request. The following fields can be specified by teachers: - `criteria` - `sourceSpreadsheetId` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric).\n\n### Response body\n\nIf successful, the response body contains an instance of [Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n| **Important:** Creating a rubric from a Google Sheet by specifying the `sourceSpreadsheetId` requires additional scopes: either `https://www.googleapis.com/auth/spreadsheets.readonly` or `https://www.googleapis.com/auth/spreadsheets`. Be aware that the `spreadsheets` scopes are considered sensitive and may require your application to be [verified](https://support.google.com/cloud/answer/9110914).\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
