Method: courses.courseWork.create

יצירת מטלות.

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

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
courseId

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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