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

במדריך הזה נסביר איך ליצור ולנהל קבצים ב-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. מידע נוסף זמין במאמר מגבלות שימוש.

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