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