Method: courses.courseWork.rubrics.patch

עדכון של קריטריון הערכה.

פרטים על השדות שאפשר לעדכן מופיעים במאמר google.classroom.v1.Rubric. היכולות של עדכון קריטריון הערכה מוגבלות אחרי שמתחילים לתת ציונים.

למשתמש המבקש ולבעלים של הקורס צריכות להיות הרשאות ליצירת קריטריונים למתן ציונים. פרטים נוספים זמינים במאמר דרישות הרישוי.

הבקשה הזו צריכה להישלח באמצעות מסוף Google Cloud של מזהה הלקוח ב-OAuth ששימש ליצירת פריט המטלה של קורס ההורה.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED אם הפרויקט של המפתח המבקש לא יצר את עבודת הקורס המתאימה, אם למשתמש אין הרשאה לבצע את השינוי המבוקש בקריטריונים למתן ציונים או בגלל שגיאות גישה. קוד השגיאה הזה מוחזר גם אם כבר התחלתם לתת ציונים לפי קריטריון הערכה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה, וגם במקרה של שגיאת בקשה הבאה:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND אם הקורס, מטלת הקורס או מערכת הדירוג המבוקשים לא קיימים, או אם למשתמש אין גישה למטלת הקורס המתאימה.
  • INTERNAL אם כבר התחלתם לתת ציונים לפי קריטריון הערכה.

בקשת HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
courseId

string

חובה. המזהה של הקורס.
courseWorkId

string

חובה. המזהה של העבודה.
id

string

זה שינוי אופציונלי. המזהה של מערכת הדירוג.

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

זה שינוי אופציונלי. מסכה שמזהה את השדות בקריטריון למתן ציונים שרוצים לעדכן. השדה הזה נדרש כדי לבצע עדכון. העדכון נכשל אם צוינו שדות לא חוקיים. יש כמה אפשרויות להגדרת הקריטריונים של קריטריון הערכה: הרשימה sourceSpreadsheetId והרשימה criteria. אפשר להשתמש רק באחד מהם בכל פעם כדי להגדיר קריטריון הערכה.

רשימת criteria של קריטריונים להערכה מוחלפת באופן מלא בקריטריונים להערכה שצוינו בבקשת העדכון. לדוגמה, אם קריטריון או רמה חסרים בבקשה, הם נמחקים. מוסיפים קריטריונים ורמות חדשים ומקצים מזהה. הקריטריונים והרמות הקיימים ימשיכו לשמור על המזהה שהוקצה להם קודם, אם המזהה צוין בבקשה.

המורים יכולים לציין את השדות הבאים:

  • criteria
  • sourceSpreadsheetId

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

זה שינוי אופציונלי. גרסת ה-Preview של ה-API. צריך להגדיר את ההגדרה הזו כדי לגשת ליכולות API חדשות שזמינות למפתחים בתוכנית ה-Preview.

גוף הבקשה

גוף הבקשה מכיל מופע של Rubric.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Rubric.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/classroom.coursework.students

מידע נוסף זמין במדריך ההרשאות.