Method: courses.topics.patch

עדכון של שדה אחד או יותר בנושא.

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

  • PERMISSION_DENIED אם הנושא התואם לא נוצר בפרויקט של המפתח המבקש, או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • FAILED_PRECONDITION אם כבר קיים קורס עם אותו שם.
  • NOT_FOUND אם הקורס או הנושא המבוקשים לא קיימים

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

המזהה של הנושא.

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

פרמטרים
updateMask

string (FieldMask format)

מסכה שמזהה את השדות בנושא שרוצים לעדכן. השדה הזה נדרש כדי לבצע עדכון. העדכון נכשל אם צוינו שדות לא חוקיים. אם שדה תומך בערכים ריקים, אפשר לנקות אותו על ידי ציון השדה במסיכת העדכון ולא באובייקט Topic. אם שדה שלא תומך בערכי ריק נכלל במסיכת העדכון ולא הוגדר באובייקט Topic, תוחזר שגיאת INVALID_ARGUMENT.

אפשר לציין את השדות הבאים:

  • name

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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