במדריך הזה מוסבר איך ליצור ולנהל קבצים ב-Google Drive באמצעות Google Drive API.
יצירת קובץ
כדי ליצור קובץ ב-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.
מגבלות ושיקולים
כשמתכוננים להעתקת קבצים, חשוב לשים לב למגבלות ולשיקולים הבאים:
הרשאות:
- האובייקט
DownloadRestrictionsMetadata
של המשאבfiles
קובע מי יכול להעתיק את הקובץ. מידע נוסף זמין במאמר בנושא מניעה ממשתמשים להוריד, להדפיס או להעתיק את הקובץ. - השדה
capabilities.canCopy
קובע אם המשתמש יכול להעתיק קובץ. מידע נוסף זמין במאמר הסבר על היכולות של קבצים. - המשתמש שיצר את העותק הוא הבעלים של הקובץ שהועתק. הגדרות שיתוף אחרות מקובץ המקור לא משוכפלות. אם העותק נוצר בתיקייה משותפת, הוא מקבל בירושה את ההרשאות של התיקייה הזו.
- הבעלות על קובץ שהועתק עשויה להשתנות, וההעתק לא יקבל את הרשאות השיתוף של הקובץ המקורי. יכול להיות שתצטרכו לאפס את ההגדרות האלה.
- האובייקט
ניהול קבצים:
- אי אפשר להעתיק קבצים מסוימים, כמו קיצורי דרך של צד שלישי.
- אפשר להעתיק קובץ רק לתיקיית אב אחת. אי אפשר לציין כמה הורים. אם השדה
parents
לא מצוין, הקובץ מקבל בירושה את כל תיקיות ההורה שאפשר לגלות מקובץ המקור. - למרות שתיקייה היא סוג של קובץ, אי אפשר להעתיק תיקייה.
במקום זאת, יוצרים תיקיית יעד ומגדירים את השדה
parents
של הקבצים הקיימים לתיקיית היעד. אחרי זה אפשר למחוק את תיקיית המקור המקורית. - אלא אם מציינים שם קובץ חדש, השיטה
files.copy
יוצרת קובץ עם אותו שם כמו הקובץ המקורי. - שימוש מוגזם ב-
files.copy
עלול לגרום לחריגה ממגבלות המכסה של Drive API. מידע נוסף זמין במאמר בנושא מגבלות שימוש.
נושאים קשורים
הנה כמה פעולות שאפשר לנסות:
כדי להעלות נתוני קבצים כשיוצרים או מעדכנים קובץ, אפשר לעיין במאמר בנושא העלאת נתוני קבצים.
כדי ליצור קובץ בתיקייה ספציפית, אפשר לעיין במאמר בנושא יצירת קובץ בתיקייה ספציפית.
כדי להעביר קבצים, אפשר לעיין במאמר בנושא העברת קבצים בין תיקיות.
מידע נוסף על עבודה עם מטא-נתונים של קבצים זמין במאמר ניהול מטא-נתונים של קבצים.
כדי למחוק קובץ, אפשר לעיין במאמר העברה לאשפה או מחיקה של קבצים ותיקיות.