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 משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
fileId

string

המזהה של הקובץ.

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

פרמטרים
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.
uploadType

string

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

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

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

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