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 כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
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

השם של טראק הטקסט עם חותמות הזמן.
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

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