עדכון המטא-נתונים ו/או התוכן של הקובץ. כשקוראים לשיטה הזו, ממלאים רק שדות בבקשה שרוצים לשנות. כשמעדכנים שדות, ייתכן ששדות מסוימים ישתנו באופן אוטומטי, כמו 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 |
הסוג של בקשת ההעלאה ל-URI של הערכים הקבילים הם:
|
fileId |
מזהה הקובץ לעדכון. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
uploadType |
הסוג של בקשת ההעלאה ל-URI של הערכים הקבילים הם:
|
addParents |
רשימה של מזהי הורה המופרדים בפסיקים שצריך להוסיף. |
convert |
הוצא משימוש: לפרמטר הזה אין פונקציה. |
enforceSingleParent |
הוצא משימוש: אין יותר תמיכה בהוספת קבצים למספר תיקיות. במקומה, צריך להשתמש במדיניות |
modifiedDateBehavior |
המדיניות קובעת את אופן העדכון של |
newRevision |
האם העלאה של blob צריכה ליצור גרסה חדשה. אם הערך הוא false, נתוני ה-blob בגרסת הדף הנוכחית יוחלפו. אם המדיניות מוגדרת כ-True או לא מוגדרת, נוצר קובץ blob חדש בתור תיקון של כותרת, וגרסאות קודמות שלא הוצמדו נשמרות למשך זמן קצר. גרסאות מוצמדות נשמרות ללא הגבלת זמן, תוך שימוש במכסת אחסון נוספת, עד 200 גרסאות קודמות. במרכז העזרה של Drive אפשר לקרוא מידע נוסף על אופן שמירת השינויים. |
ocr |
אם לנסות OCR בקובצי העלאה מסוג .jpg, .png, .gif או .pdf |
ocrLanguage |
אם אובייקט אמיתי אמיתי, רמזו על השפה לשימוש. הערכים החוקיים הם קודי BCP 47. |
pinned |
האם להצמיד את הגרסה החדשה. בקובץ יכולים להיות עד 200 תיקונים מוצמדים. |
removeParents |
רשימה של מזהי הורה המופרדים באמצעות פסיקים. |
setModifiedDate |
האם להגדיר את תאריך השינוי באמצעות הערך שסופק בגוף הבקשה. הגדרת השדה הזה לערך |
supportsAllDrives |
אם הבקשה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: במקומה יש להשתמש ב- |
timedTextLanguage |
שפת הטקסט המתוזמן. |
timedTextTrackName |
השם של רצועת הטקסט המתוזמנת. |
updateViewedDate |
האם לעדכן את תאריך התצוגה לאחר עדכון מוצלח של הקובץ. |
useContentAsIndexableText |
האם להשתמש בתוכן כטקסט שניתן להוסיף לאינדקס. |
includePermissionsForView |
מציינת אילו הרשאות נוספות לתצוגה ייכללו בתשובה. רק |
includeLabels |
רשימת מזהים של תוויות שמופרדות בפסיקים, שצריך לכלול בחלק |
גוף הבקשה
גוף הבקשה מכיל מופע של 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
היקפי הרשאות מסוימים מוגבלים וחובה להפעיל הערכה אבטחה כדי להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאה.