פרטים על השדות שאפשר לעדכן מופיעים במאמר google.classroom.v1.Rubric. היכולות של עדכון קריטריון הערכה מוגבלות אחרי שמתחילים לתת ציונים.
למשתמש המבקש ולבעלים של הקורס צריכות להיות הרשאות ליצירת קריטריונים למתן ציונים. פרטים נוספים זמינים במאמר דרישות הרישוי.
הבקשה הזו צריכה להישלח על ידי מסוף Google Cloud של מזהה הלקוח ב-OAuth ששימש ליצירת פריט המטלה של קורס ההורה.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED אם הפרויקט של המפתח המבקש לא יצר את עבודת הקורס המתאימה, אם למשתמש אין הרשאה לבצע את השינוי המבוקש בקריטריונים למתן ציונים או בגלל שגיאות גישה. קוד השגיאה הזה מוחזר גם אם כבר התחלתם לתת ציונים לפי קריטריון הערכה.
INVALID_ARGUMENT אם הבקשה לא תקינה, וגם במקרה של שגיאת הבקשה הבאה:
RubricCriteriaInvalidFormat
NOT_FOUND אם הקורס, מטלת הקורס או מערכת הדירוג המבוקשים לא קיימים, או אם למשתמש אין גישה למטלת הקורס המתאימה.
INTERNAL אם כבר התחלתם לתת ציונים לפי קריטריון הערכה.
אופציונלי. מסכה שמזהה את השדות בקריטריון למתן ציונים שרוצים לעדכן. השדה הזה נדרש כדי לבצע עדכון. העדכון נכשל אם צוינו שדות לא חוקיים. יש כמה אפשרויות להגדרת הקריטריונים של קריטריון הערכה: הרשימה sourceSpreadsheetId והרשימה criteria. אפשר להשתמש רק באחד מהם בכל פעם כדי להגדיר קריטריון הערכה.
רשימת criteria של קריטריונים להערכה מוחלפת באופן מלא בקריטריונים להערכה שצוינו בבקשת העדכון. לדוגמה, אם קריטריון או רמה חסרים בבקשה, הם נמחקים. מוסיפים קריטריונים ורמות חדשים ומקצים מזהה. הקריטריונים והרמות הקיימים ימשיכו לשמור על המזהה שהוקצה להם קודם, אם המזהה צוין בבקשה.
המורים יכולים לציין את השדות הבאים:
criteria
sourceSpreadsheetId
זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
[null,null,["עדכון אחרון: 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)."]]
