Method: courses.courseWork.rubrics.list

הפונקציה מחזירה רשימה של קריטריונים למתן ציונים שהמבקש מורשה להציג.

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

  • PERMISSION_DENIED עבור שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס או מטלת הקורס המבוקשים לא קיימים, או אם למשתמש אין גישה למטלת הקורס המתאימה.

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
pageSize

integer

המספר המקסימלי של קריטריונים להערכה שיוחזר. אם לא מצוין, תוחזר רשימת ציונים אחת לכל היותר. הערך המקסימלי הוא 1. ערכים מעל 1 יכופו לערך 1.
pageToken

string

הערך nextPageToken שהוחזר מקריאה קודמת של list, ומציין שצריך להחזיר את דף התוצאות הבא.

הבקשה list חייבת להיות זהה לזו שהובילה ליצירת האסימון הזה, בכל שאר הפרטים.
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

התגובה שמופיעה כשמציגים רשימה של קריטריונים למתן ציונים.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "rubrics": [
    {
      object (Rubric)
    }
  ],
  "nextPageToken": string
}
שדות
rubrics[]

object (Rubric)

קריטריונים שתואמים לבקשה.
nextPageToken

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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