יצירה וניהול של קבצים

במדריך הזה נסביר איך ליצור ולנהל קבצים ב-Google Drive.

יצירת קובץ

כדי ליצור קובץ ב-Drive שלא מכיל מטא-נתונים או תוכן, משתמשים בשיטה files.create() ללא פרמטרים. הקובץ מקבל kind של drive.file, id, name של 'Untitled' ו-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. מידע נוסף זמין במאמר מגבלות שימוש.

נושאים קשורים

הנה כמה שלבים אפשריים שאפשר לנסות:

• במאמר העלאת נתוני קבצים מוסבר איך מעלים נתוני קבצים כשיוצרים או מעדכנים אותם.

• במאמר יצירת קובץ בתיקייה ספציפית מוסבר איך יוצרים קובץ בתיקייה ספציפית.

• במאמר העברת קבצים בין תיקיות מוסבר איך עושים את זה.

• במאמר ניהול המטא-נתונים של קבצים מוסבר איך עובדים עם מטא-נתונים של קבצים.

• במאמר העברה לאשפה או מחיקה של קבצים ותיקיות מוסבר איך למחוק קובץ.