Method: courses.create

יצירת קורס.

המשתמש שצוין ב-ownerId הוא הבעלים של הקורס שנוצר ונוסף כמורה. משתמש שאינו מנהל מערכת שביקש אותו יכול ליצור קורס רק בעצמו כבעלים של הקורס. מנהלי דומיינים יכולים ליצור קורסים בבעלות של כל משתמש בדומיין.

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

  • PERMISSION_DENIED אם המשתמש ששלח את הבקשה לא מורשה ליצור קורסים או בגלל שגיאות גישה.
  • NOT_FOUND אם המורה הראשי/ת לא משתמש/ת חוקי/ת.
  • FAILED_PRECONDITION אם החשבון של בעלי הקורס מושבת או בגלל שגיאות הבקשה הבאות:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • ALREADY_EXISTS אם כינוי צוין ב-id וכבר קיים.

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

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