Method: courses.checkGradingPeriodsSetupEligibility

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

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

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

string

בלתי ניתן לשינוי. מזהה הקורס.
isGradingPeriodsSetupEligible

boolean

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

enum (PreviewVersion)

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

היקפי ההרשאות

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

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

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