Method: courses.courseWork.rubrics.create

יוצר קריטריון הערכה.

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

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

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
courseId

string

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

courseWorkId

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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