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.

פרמטרים של שאילתה

פרמטרים
previewVersion

enum (PreviewVersion)

אופציונלי. גרסת הטרום-השקה של ה-API. ההגדרה הזו נדרשת כדי לגשת ליכולות חדשות של API שזמינות למפתחים בתוכנית ההפצה המקדימה.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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