Method: files.update

עדכון המטא-נתונים ו/או התוכן של קובץ. כשקוראים לשיטה הזו, ממלאים רק את השדות בבקשה שרוצים לשנות. כשמעדכנים שדות, יכול להיות ששדות מסוימים ישתנו באופן אוטומטי, כמו modifiedDate. השיטה הזו תומכת בסמינטיקה של תיקונים.

השיטה הזו תומכת ב-URI מסוג ‎/upload ומקבלת מדיה שהועלו עם המאפיינים הבאים:

  • גודל הקובץ המקסימלי: 5,120GB
  • סוגי ה-MIME המותרים של מדיה:*/*

הערה: צריך לציין סוג MIME תקין, ולא את הערך המילולי */*. המחרוזת */* משמשת רק כדי לציין שאפשר להעלות כל סוג MIME חוקי.

מידע נוסף על העלאת קבצים זמין במאמר העלאת נתוני קבצים.

בקשת HTTP

  • URI להעלאה, לבקשות העלאה של מדיה:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

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

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

פרמטרים
fileId

string

המזהה של הקובץ שרוצים לעדכן.

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

פרמטרים
addParents

string

רשימה מופרדת בפסיקים של מזהי ההורים להוספה.
convert
(deprecated)

boolean

הפרמטר הזה הוצא משימוש: אין לו פונקציה.
enforceSingleParent
(deprecated)

boolean

הוצא משימוש: אין יותר תמיכה בהוספת קבצים לכמה תיקיות. במקום זאת, אתם צריכים להשתמש ב-shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

קובע את ההתנהגות שבה modifiedDate מתעדכן. האפשרות הזו מבטלת את setModifiedDate.
newRevision

boolean

האם המערכת צריכה ליצור גרסה חדשה של blob שהועלו. אם הערך הוא false, נתוני ה-blob בגרסה הנוכחית של ה-head יוחלפו. אם הערך הוא true או לא מוגדר, נוצר blob חדש בתור גרסת ה-head, וגרסאות קודמות שלא הוצמדו נשארות למשך פרק זמן קצר. גרסאות מוצמדות מאוחסנות ללא הגבלת זמן, תוך שימוש במכסת אחסון נוספת, עד 200 גרסאות לכל היותר. פרטים על אופן השמירה של הגרסאות נמצאים במרכז העזרה של Drive.
ocr

boolean

האם לנסות לבצע OCR בהעלאות של קבצים בפורמטים ‎ .jpg,‏ ‎.png,‏ ‎.gif או ‎ .pdf.
ocrLanguage

string

אם הערך של ocr הוא true, מוצגות רמזים לגבי השפה שבה צריך להשתמש. הערכים החוקיים הם קודים של BCP 47.
pinned

boolean

האם להצמיד את הגרסה החדשה. בכל קובץ אפשר להצמיד עד 200 גרסאות.
removeParents

string

רשימה מופרדת בפסיקים של מזהי ההורים להסרה.
setModifiedDate

boolean

האם להגדיר את תאריך השינוי באמצעות הערך שסופק בגוף הבקשה. הגדרת השדה הזה כ-true זהה להגדרה כ-modifiedDateBehavior=fromBodyOrNow, והגדרה כ-false זהה להגדרה כ-modifiedDateBehavior=now. כדי למנוע שינויים בקבוצת התאריכים ששונו modifiedDateBehavior=noChange.
supportsAllDrives

boolean

האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
timedTextLanguage

string

השפה של הטקסט המתוזמן.
timedTextTrackName

string

השם של טראק הטקסט המתוזמן.
updateViewedDate

boolean

האם לעדכן את תאריך הצפייה אחרי העדכון המוצלח של הקובץ.
uploadType

string

סוג בקשת ההעלאה למזהה ה-URI /upload. אם מעלים נתונים עם URI מסוג /upload, השדה הזה חובה. אם אתם יוצרים קובץ מטא-נתונים בלבד, השדה הזה לא נדרש. בנוסף, השדה הזה לא מוצג בווידג'ט 'ניסיון השיטה הזו' כי הווידג'ט לא תומך בהעלאות נתונים.

הערכים הקבילים הם:

  • media – העלאה פשוטה. מעלים את המדיה בלבד, ללא מטא-נתונים.
  • multipart – העלאה בכמה חלקים. להעלות את המדיה ואת המטא-נתונים שלה בבקשה אחת.
  • resumable – העלאה שניתן להמשיך. מעלים את הקובץ באופן שניתן להמשיך אותו, באמצעות סדרה של לפחות שתי בקשות, כאשר הבקשה הראשונה כוללת את המטא-נתונים.
useContentAsIndexableText

boolean

אם להשתמש בתוכן כטקסט שאפשר להוסיף לאינדקס.
includePermissionsForView

string

מציין אילו הרשאות של תצוגה נוספת צריך לכלול בתשובה. יש תמיכה רק ב-published.
includeLabels

string

רשימה מופרדת בפסיקים של מזהי תוויות שרוצים לכלול בחלק labelInfo של התשובה.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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