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, השדה הזה הוא שדה חובה. אם אתם יוצרים קובץ של מטא-נתונים בלבד, השדה הזה לא חובה. השדה הזה גם לא מוצג בווידג'ט "Try this method" כי הווידג'ט לא תומך בהעלאת נתונים.

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

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

string

מזהה הקובץ.

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

פרמטרים
uploadType

string

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

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

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

string

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

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

האם להגדיר את השדה 'keepForever' בגרסה החדשה של כותרת. ההגדרה הזו רלוונטית רק לקבצים עם תוכן בינארי ב-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

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