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

מדריך זה מסביר כיצד ליצור ולנהל קבצים ב-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.

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

מגבלות ושיקולים

במהלך ההכנה להעתקת קבצים, חשוב לשים לב למגבלות ולשיקולים הבאים:

  • הרשאות:

    • הגבלת הקובץ copyRequiresWriterPermission קובעת מי יכול להעתיק את הקובץ. מידע נוסף זמין במאמר איך למנוע ממשתמשים להוריד, להדפיס או להעתיק את הקובץ.
    • השדה capabilities/canCopy במשאב files קובע אם המשתמש יכול להעתיק קובץ. אפשר לקרוא מידע נוסף בקטע יכולות.
    • המשתמש שיצר את העותק הוא הבעלים של הקובץ שהועתק. הגדרות שיתוף נוספות מקובץ המקור לא מועתקות. אם העותק נוצר בתיקייה משותפת, הוא יורש את ההרשאות של התיקייה הזו.
    • יכול להיות שהבעלות על קובץ שהועתק לא תשתנה, ויכול להיות שהעותק לא יירש את הגדרות השיתוף של הקובץ המקורי. יכול להיות שצריך לאפס את ההגדרות האלה.

  • ניהול קבצים:

    • קבצים מסוימים, כמו קיצורי דרך של צד שלישי, אי אפשר להעתיק אף פעם.
    • אפשר להעתיק קובץ רק לתיקיית הורה אחת. אין תמיכה בציון הורה מרובים. אם השדה parents לא צוין, הקובץ יורש את כל תבניות ההורה הגלויות מקובץ המקור.
    • למרות שתיקייה היא סוג של קובץ, אי אפשר להעתיק תיקייה. במקום זאת, צריך ליצור תיקיית יעד ולהגדיר את השדה parents בקבצים הקיימים לתיקיית היעד. לאחר מכן אפשר למחוק את תיקיית המקור המקורית.
    • אם לא מציינים שם קובץ חדש, השיטה files.copy יוצרת קובץ עם שם זהה למקור.
    • שימוש מוגזם ב-files.copy עלול להוביל לחריגה מהמכסות שלכם ב-Drive API. למידע נוסף, קראו את המאמר מגבלות השימוש.

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