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

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

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

string

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

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

פרמטרים
uploadType

string

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

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

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

string

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

convert
(deprecated)

boolean

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

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum (ModifiedDateBehavior)

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

newRevision

boolean

האם העלאה של blob צריכה ליצור גרסה חדשה. אם הערך הוא false, נתוני ה-blob בגרסת הדף הנוכחית יוחלפו. אם המדיניות מוגדרת כ-True או לא מוגדרת, נוצר קובץ blob חדש בתור תיקון של כותרת, וגרסאות קודמות שלא הוצמדו נשמרות למשך זמן קצר. גרסאות מוצמדות נשמרות ללא הגבלת זמן, תוך שימוש במכסת אחסון נוספת, עד 200 גרסאות קודמות. במרכז העזרה של Drive אפשר לקרוא מידע נוסף על אופן שמירת השינויים.

ocr

boolean

אם לנסות OCR בקובצי העלאה מסוג .jpg, .png, .gif או .pdf

ocrLanguage

string

אם אובייקט אמיתי אמיתי, רמזו על השפה לשימוש. הערכים החוקיים הם קודי 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

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