Method: files.update

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

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

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
addParents

string

רשימה של מזהים של הורים להוספה, שמופרדים באמצעות פסיקים.
convert
(deprecated)

boolean

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

boolean

הוצאה משימוש: אין יותר תמיכה בהוספת קבצים לכמה תיקיות. במקום זאת, אתם צריכים להשתמש ב-shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

קובעת את ההתנהגות שבה modifiedDate מתעדכן. ההגדרה הזו מבטלת את setModifiedDate.
newRevision

boolean

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

boolean

האם לנסות OCR בהעלאות של קובצי ‎ .jpg,‏ ‎.png,‏ ‎.gif או ‎ .pdf.
ocrLanguage

string

אם ocr הוא true, מופיעות הצעות לשפה שבה כדאי להשתמש. הערכים החוקיים הם קודים מסוג 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

האם לעדכן את תאריך התצוגה אחרי עדכון מוצלח של הקובץ.
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/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

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