Method: courses.create

יוצר קורס.

המשתמש שצוין ב-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

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