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 נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
courseId

string

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

string

חובה. מזהה העבודה בקורס.
id

string

אפשרות. המזהה של קריטריון ההערכה.

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

פרמטרים
updateMask

string (FieldMask format)

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

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

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

  • criteria
  • sourceSpreadsheetId

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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