Method: files.update

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

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

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

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

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

בקשת HTTP

  • יש להעלות URI, עבור בקשות להעלאת מדיה:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI של מטא-נתונים, לבקשות למטא-נתונים בלבד:
    PATCH https://www.googleapis.com/drive/v3/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

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

boolean

הוצאה משימוש: אין יותר תמיכה בהוספת קבצים למספר תיקיות. במקום זאת, אפשר להשתמש בקיצורי דרך.
keepRevisionForever

boolean

האם להגדיר את השדה 'keepForever' בגרסת ה-head החדשה. אפשרות זו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. ניתן לשמור רק עד 200 גרסאות קודמות של הקובץ באופן סופי. אם הגעת למגבלה, אפשר לנסות למחוק גרסאות קודמות מוצמדות.
ocrLanguage

string

רמז לשפה לעיבוד OCR במהלך ייבוא תמונה (קוד ISO 639-1).
removeParents

string

רשימה של מזהי הורה שצריך להסיר, שמופרדים בפסיקים.
supportsAllDrives

boolean

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

boolean

הוצאה משימוש: יש להשתמש במקום זאת ב-supportsAllDrives.
useContentAsIndexableText

boolean

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

string

ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. רק הערך 'פורסם' נתמך.
includeLabels

string

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

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