Method: courses.courseWorkMaterials.addOnAttachments.patch

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

כדי להשתמש בקובץ הזה צריך לוודא שהתוסף היה היוצר המקורי של הקובץ המצורף.

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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

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