Method: files.patch

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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 חדש נוצר כגרסת כותרת, וגרסאות קודמות שלא הוצמדו נשמרות לפרק זמן קצר. גרסאות קודמות מוצמדות נשמרות ללא הגבלת זמן תוך שימוש במכסת אחסון נוספת, עד 200 גרסאות קודמות לכל היותר. במרכז העזרה של Drive אפשר לקרוא מידע נוסף על האופן שבו גרסאות קודמות נשמרות. הערה: אם אין מטען ייעודי (payload) בבקשה, המערכת תתעלם מהשדה הזה.

ocr

boolean

האם לנסות להשתמש ב-OCR בהעלאות .jpg, .png, .gif או .pdf.

ocrLanguage

string

אם ocr הוא true, , רמזים לגבי השפה שבה יש להשתמש. הערכים החוקיים הם קודי BCP 47.

pinned

boolean

בחירה אם להצמיד את הגרסה החדשה. לכל קובץ יכולים להיות 200 גרסאות קודמות מוצמדות. הערה: אם אין מטען ייעודי (payload) בבקשה, המערכת תתעלם מהשדה הזה.

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

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