Method: files.create

יצירת קובץ חדש.

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

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

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

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

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

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
enforceSingleParent

boolean

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

boolean

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

boolean

האם להגדיר את השדה 'keepForever' בגרסה החדשה של ה-head. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. אפשר לשמור לתמיד רק 200 גרסאות של הקובץ. אם הגעתם למגבלה, נסו למחוק גרסאות מוצמדות.
ocrLanguage

string

רמז לשפה לעיבוד OCR במהלך ייבוא התמונה (קוד ISO 639-1).
supportsAllDrives

boolean

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

boolean

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

string

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

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

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

boolean

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

string

מציין אילו הרשאות של תצוגה נוספת צריך לכלול בתשובה. יש תמיכה רק באפשרות 'פורסם'.
includeLabels

string

רשימה מופרדת בפסיקים של מזהי תוויות שרוצים לכלול בחלק labelInfo של התשובה.

גוף הבקשה

גוף הבקשה מכיל מופע של File.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של File.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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