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

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

פרמטרים
uploadType

string

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

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

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

string

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

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

פרמטרים
uploadType

string

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

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

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

string

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

boolean

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

boolean

הוצאה משימוש: אין יותר תמיכה בהוספת קבצים למספר תיקיות. במקומה צריך להשתמש במדיניות shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

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

boolean

האם העלאה של blob צריכה ליצור גרסה חדשה. אם המדיניות הזו מוגדרת כ-False, נתוני ה-blob בגרסת ה-head הנוכחית מוחלפים. אם המדיניות הזו מוגדרת כ-True או לא מוגדרת, אובייקט חדש מסוג blob חדש נוצר כגרסת כותרת, וגרסאות קודמות שלא הוצמדו נשמרות לפרק זמן קצר. גרסאות קודמות מוצמדות נשמרות ללא הגבלת זמן תוך שימוש במכסת אחסון נוספת, עד 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

האם לעדכן את תאריך התצוגה לאחר עדכון מוצלח של הקובץ.
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

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