Method: files.insert

הוספת קובץ חדש.

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

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

הערה: צריך לציין סוג MIME חוקי, ולא את הערך המילולי */*. הערך המילולי */* משמש רק כדי לציין שניתן להעלות כל סוג MIME חוקי.

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

באפליקציות שיוצרות קיצורי דרך עם files.insert חובה לציין את סוג ה-MIME application/vnd.google-apps.shortcut.

באפליקציות צריך לציין סיומת קובץ במאפיין title כשמוסיפים קבצים באמצעות ה-API. לדוגמה, פעולה להוספת קובץ JPEG צריכה לכלול במטא-נתונים משהו כמו "title": "cat.jpg".

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
uploadType

string

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

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

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

boolean

בחירה אם להמיר את הקובץ הזה לפורמט המתאים של עורכי Docs.
enforceSingleParent
(deprecated)

boolean

הוצאה משימוש: אי אפשר יותר ליצור קבצים בכמה תיקיות.
ocr

boolean

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

string

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

boolean

בחירה אם להצמיד את הגרסה הראשית של הקובץ שהועלה. לכל קובץ יכולים להיות 200 גרסאות קודמות מוצמדות.
supportsAllDrives

boolean

האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

הוצאה משימוש: יש להשתמש במקום זאת ב-supportsAllDrives.
timedTextLanguage

string

השפה של הטקסט המתוזמן.
timedTextTrackName

string

השם של רצועת הטקסט המתוזמנת.
useContentAsIndexableText

boolean

האם להשתמש בתוכן כטקסט שניתן להוסיף לאינדקס.
visibility

enum (Visibility)

סטטוס החשיפה של הקובץ החדש. הפרמטר הזה רלוונטי רק כאשר conversion=false.
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

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