Method: courses.checkGradingPeriodsSetupEligibility

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

השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-UserProfiles.checkUserCapability.

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

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

בקשת HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility

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

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

פרמטרים
courseId

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

האם המשתמש מורשה לעדכן את GradingPeriodSettings בקורס הזה.

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

ייצוג ב-JSON
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
שדות
courseId

string

קבוע. המזהה של הקורס.

isGradingPeriodsSetupEligible

boolean

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

previewVersion

enum (PreviewVersion)

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

היקפי הרשאה

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

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

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