Method: files.insert

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

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

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

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

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

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

כשאתם מוסיפים קבצים באמצעות ה-API, עליכם לציין את סיומת הקובץ במאפיין title. לדוגמה, פעולה להוספת קובץ 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 משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
convert

boolean

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

boolean

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

boolean

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

string

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

boolean

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

boolean

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

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
timedTextLanguage

string

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

string

השם של טראק הטקסט המתוזמן.
uploadType

string

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

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

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

boolean

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

enum (Visibility)

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

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