Method: files.update

עדכון של המטא-נתונים, התוכן או שניהם של קובץ.

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

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

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

    (צריך לציין סוג MIME תקין, ולא את הערך המילולי */*. המחרוזת */* משמשת רק כדי לציין שאפשר להעלות כל סוג MIME תקין. מידע נוסף זמין במאמר סוגי MIME נתמכים ב-Google Workspace וב-Google Drive).

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

בקשת HTTP

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

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

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

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

מציין אילו הרשאות של תצוגות נוספות לכלול בתשובה. יש תמיכה רק ב-published.
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

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