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

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