יוצר קורס.
המשתמש שצוין ב-ownerId הוא הבעלים של הקורס שנוצר והוא נוסף כמורה. משתמש שאין לו הרשאת אדמין יכול ליצור קורס רק כשהוא הבעלים שלו. אדמינים בדומיין יכולים ליצור קורסים בבעלות של כל משתמש בדומיין שלהם.
השיטה הזו מחזירה את קודי השגיאה הבאים:
-
PERMISSION_DENIEDאם למשתמש ששולח את הבקשה אין הרשאה ליצור קורסים או אם יש שגיאות גישה. -
NOT_FOUNDאם המורה הראשי הוא לא משתמש תקין. -
FAILED_PRECONDITIONאם החשבון של בעל הקורס מושבת או אם מתקבלות שגיאות בבקשה הבאות:- UserCannotOwnCourse
- UserGroupsMembershipLimitReached
- CourseTitleCannotContainUrl
ALREADY_EXISTSאם צוין כינוי ב-idוהוא כבר קיים.
בקשת HTTP
POST https://classroom.googleapis.com/v1/courses
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
גוף הבקשה
גוף הבקשה מכיל מופע של Course.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Course.
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/classroom.courses
מידע נוסף זמין במדריך ההרשאות.