Method: files.patch

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

בקשת HTTP

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

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

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

פרמטרים
fileId

string

המזהה של הקובץ שרוצים לעדכן.

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

פרמטרים
addParents

string

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

boolean

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

boolean

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

enum (ModifiedDateBehavior)

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

boolean

האם המערכת צריכה ליצור גרסה חדשה של blob שהועלו. אם הערך הוא false, נתוני ה-blob בגרסה הנוכחית של ה-head יוחלפו. אם הערך הוא true או לא מוגדר, נוצר blob חדש בתור גרסת ה-head, וגרסאות קודמות שלא הוצמדו נשארות למשך פרק זמן קצר. גרסאות מוצמדות מאוחסנות ללא הגבלת זמן, תוך שימוש במכסת אחסון נוספת, עד 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

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

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