Method: files.create

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

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

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

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

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

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

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

בקשות GET עוקבות כוללות את המאפיין fileExtension לקריאה בלבד, שאוכלס בתוסף שצוין במקור במאפיין name. כשמשתמש ב-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 משתמשת בתחביר של gRPC Transcoding.

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

פרמטרים
enforceSingleParent
(deprecated)

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

מציין אילו הרשאות של תצוגות נוספות לכלול בתשובה. יש תמיכה רק ב-published.
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

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