Method: courses.courseWork.create

יצירת עבודה בקורס.

העבודות שייווצרו בקורס (וההגשות התואמות של התלמידים) משויכות לפרויקט ב-Developer Console עם מזהה הלקוח של OAuth ששימש לשליחת הבקשה. בקשות של Classroom API לשינוי עבודות של תלמידים והגשות של תלמידים חייבות להתבצע עם מספר לקוח ב-OAuth מהפרויקט המשויך ב-Developer Console.

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

  • PERMISSION_DENIED אם המשתמש ששלח את הבקשה לא מורשה לגשת לקורס המבוקש, ליצור עבודות בקורס בקורס המבוקש, לשתף קובץ מצורף מ-Drive או במקרה של שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה בפורמט שגוי.
  • NOT_FOUND אם הקורס המבוקש לא קיים.
  • FAILED_PRECONDITION בשגיאת הבקשה הבאה:
    • AttachmentNotVisible

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
courseId

string

מזהה הקורס. המזהה הזה יכול להיות המזהה שהוקצה על ידי Classroom או alias.

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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