Method: courses.create

יצירת קורס.

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

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

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

בקשת HTTP

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

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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