יצירת קורס.
המשתמש שצוין ב-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
למידע נוסף, ניתן לעיין במדריך ההרשאות.