Method: courses.announcements.addOnAttachments.patch

עדכון של קובץ מצורף של תוסף.

נדרש שהתוסף יהיה היוצר המקורי של הקובץ המצורף.

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

  • PERMISSION_DENIED עבור שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם אחד מהמשאבים שזוהו לא קיים.

בקשת HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}

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

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

פרמטרים
courseId

string

חובה. המזהה של הקורס.

itemId

string

המזהה של הפוסט שאליו מצורף הקובץ.

attachmentId

string

חובה. המזהה של הקובץ המצורף.

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

פרמטרים
postId

string

חובה. המזהה של הפוסט שאליו מצורף הקובץ.

updateMask

string (FieldMask format)

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

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

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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