Method: files.create

• בקשת HTTP
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי הרשאות
• רוצים לנסות?

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

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

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

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

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

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

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

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

פרמטרים
uploadType	string הסוג של בקשת ההעלאה ל-URI של /upload. אם מעלים נתונים עם URI מסוג /upload, חובה למלא את השדה הזה. אם יוצרים קובץ של מטא-נתונים בלבד, חובה למלא את השדה הזה. בנוסף, השדה הזה לא מוצג בווידג'ט 'אני רוצה לנסות את השיטה הזו' כי הווידג'ט לא תומך בהעלאות נתונים. הערכים הקבילים הם: media – העלאה פשוטה. יש להעלות את המדיה בלבד, ללא מטא-נתונים. multipart - העלאה מרובת חלקים. אפשר להעלות את המדיה וגם את המטא-נתונים שלה, בבקשה אחת. resumable - העלאה ניתנת לחידוש. מעלים את הקובץ באופן שניתן לחידוש, באמצעות סדרה של שתי בקשות לפחות שבהן הבקשה הראשונה כוללת את המטא-נתונים.
enforceSingleParent	boolean הוּצא משימוש. כבר אי אפשר ליצור קבצים במספר תיקיות.
ignoreDefaultVisibility	boolean האם להתעלם מהגדרות ברירת המחדל של הרשאות גישה לדומיין שנוצר. מנהלי דומיין יכולים להגדיר את כל הקבצים שהועלו כגלויים לדומיין כברירת מחדל. הפרמטר הזה יעקוף את ההתנהגות הזו של הבקשה. ההרשאות עדיין עוברות בירושה מהתיקיות הראשיות.
keepRevisionForever	boolean האם להגדיר את השדה 'keepForever' בגרסת ה-head החדשה. אפשרות זו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. ניתן לשמור רק עד 200 גרסאות קודמות של הקובץ באופן סופי. אם הגעת למגבלה, אפשר לנסות למחוק גרסאות קודמות מוצמדות.
ocrLanguage	string רמז לשפה לעיבוד OCR במהלך ייבוא תמונה (קוד ISO 639-1).
supportsAllDrives	boolean האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives (deprecated)	boolean הוצאה משימוש: יש להשתמש במקום זאת ב-supportsAllDrives.
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

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