Method: courses.update

עדכון קורס.

הערה: בניגוד לשדות אחרים, אם לא מציינים את levels בבקשה, הוא לא מתרוקן. ה-method‏ courses.update משנה את levels רק אם הוא צוין במפורש. אחרת, הערך הקיים נשמר. משתמשים ב-courses.patch method כדי לנקות את השדה levels.

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

  • ‫PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה לשנות את הקורס המבוקש או אם מדובר בשגיאות גישה.
  • ‫NOT_FOUND אם לא קיים קורס עם המזהה המבוקש.
  • FAILED_PRECONDITION עבור שגיאות הבקשה הבאות:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

בקשת HTTP

PUT https://classroom.googleapis.com/v1/courses/{id}

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

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

פרמטרים
id

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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