Method: courses.topics.create

יצירת נושא.

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

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה לגשת לקורס המבוקש, ליצור נושא בקורס המבוקש או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • ALREADY_EXISTS אם כבר קיים קורס עם אותו שם.
  • FAILED_PRECONDITION לשגיאת הבקשה הבאה:
    • CourseTopicLimitReached
  • NOT_FOUND אם הקורס המבוקש לא קיים.

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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