Method: courses.topics.patch

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתות
• גוף הבקשה
• גוף התשובה
• היקפי הרשאה
• רוצים לנסות?

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

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

• PERMISSION_DENIED אם הנושא התואם לא נוצר בפרויקט של המפתח המבקש, או בגלל שגיאות גישה.
• INVALID_ARGUMENT אם הבקשה לא תקינה.
• 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

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