במדריך הזה נסביר איך ליצור ולנהל קבצים ב-Google Drive.
יצירת קובץ
כדי ליצור קובץ ב-Drive שלא מכיל מטא-נתונים או תוכן, משתמשים בשיטה files.create
ללא פרמטרים. הקובץ מקבל את המאפיין kind
של drive.file
, את הערך id
, את הערך name
של השדה 'ללא שם', ואת הערך mimeType
של application/octet-stream
. השדה uploadType
מסומן כחובה, אבל ברירת המחדל שלו היא media
, כך שאין צורך לספק אותו בפועל.
מידע נוסף על מגבלות הקבצים ב-Drive זמין במאמר מגבלות על קבצים ותיקיות.
יצירת קבצים של מטא-נתונים בלבד
קבצים של מטא-נתונים בלבד לא מכילים תוכן. מטא-נתונים הם נתונים (כמו name
, mimeType
ו-createdTime
) שמתארים את הקובץ. שדות כמו name
הם לא תלויים במשתמש ומופיעים באותו אופן לכל משתמש, בעוד ששדות כמו viewedByMeTime
מכילים ערכים ספציפיים למשתמש.
דוגמה לקובץ מטא-נתונים בלבד היא תיקייה עם סוג ה-MIME application/vnd.google-apps.folder
. מידע נוסף זמין במאמר יצירה ומילוי של תיקיות. דוגמה נוספת היא קיצור דרך שמפנה לקובץ אחר ב-Drive עם סוג ה-MIME application/vnd.google-apps.shortcut
. למידע נוסף, ראו יצירת קיצור דרך לקובץ ב-Drive.
ניהול תמונות ממוזערות
תמונות ממוזערות עוזרות למשתמשים לזהות קבצים ב-Drive. מערכת Drive יכולה ליצור באופן אוטומטי תמונות ממוזערות של סוגי קבצים נפוצים, או שתוכלו לספק תמונה ממוזערת שנוצרה על ידי האפליקציה. מידע נוסף זמין במאמר העלאת תמונות ממוזערות.
העתקה של קובץ קיים
כדי להעתיק קובץ ולהחיל את העדכונים המבוקשים, משתמשים ב-method files.copy
. כדי למצוא את fileId
להעתקה, משתמשים בשיטה files.list
.
חשוב לזכור שצריך להשתמש בהיקף מתאים של Drive API כדי לאשר את הקריאה. מידע נוסף על היקפי הרשאות ב-Drive זמין במאמר בחירת היקפי הרשאות ל-Google Drive API.
מגבלות ושיקולים
לפני שמעתיק קבצים, חשוב לשים לב למגבלות ולשיקולים הבאים:
הרשאות:
- הגבלת הקובץ
copyRequiresWriterPermission
קובעת מי יכול להעתיק את הקובץ. מידע נוסף זמין במאמר איך מונעים ממשתמשים להוריד, להדפיס או להעתיק את הקובץ. - השדה
capabilities/canCopy
של המשאבfiles
קובע אם המשתמש יכול להעתיק קובץ. מידע נוסף זמין בקטע יכולות. - הבעלות על הקובץ המועתק היא של המשתמש שיצר את העותק. לא מתבצעת שכפול של הגדרות שיתוף אחרות מהקובץ המקור. אם העותק נוצר בתיקייה משותפת, הוא יקבל בירושה את ההרשאות של התיקייה הזו.
- יכול להיות שהבעלות על קובץ שהועתק תשתנה, ויכול להיות שהעותק לא יקבל בירושה את הגדרות השיתוף של הקובץ המקורי. יכול להיות שתצטרכו לאפס את ההגדרות האלה.
- הגבלת הקובץ
ניהול קבצים:
- אי אפשר להעתיק אף פעם קבצים מסוימים, כמו קיצורי דרך של צד שלישי.
- אפשר להעתיק קובץ רק לתיקיית הורה אחת. אי אפשר לציין כמה הורים. אם לא מציינים את השדה
parents
, הקובץ יקבל בירושה מקבץ המקור את כל ההורים שניתנים לגילוי. - למרות שתיקייה היא סוג של קובץ, אי אפשר להעתיק תיקייה.
במקום זאת, יוצרים תיקיית יעד ומגדירים את השדה
parents
של הקבצים הקיימים לתיקיית היעד. לאחר מכן תוכלו למחוק את תיקיית המקור המקורית. - אם לא מציינים שם קובץ חדש, השיטה
files.copy
יוצרת קובץ עם שם שזהה לשם המקורי. - שימוש מוגזם ב-
files.copy
עלול לגרום לחריגה ממגבלות המכסות שלכם ב-Drive API. מידע נוסף זמין במאמר מגבלות שימוש.
נושאים קשורים
אפשר לנסות את הפתרונות הבאים:
כדי להעלות נתוני קובץ כשיוצרים או מעדכנים קובץ, ראו העלאת נתוני קובץ.
במאמר יצירת קובץ בתיקייה ספציפית מוסבר איך יוצרים קובץ בתיקייה ספציפית.
במאמר ניהול המטא-נתונים של הקובץ מוסבר איך עובדים עם מטא-נתונים של קובץ.
במאמר העברה לאשפה או מחיקה של קבצים ותיקיות מוסבר איך למחוק קובץ.