תיקיות הן קבצים שמכילים רק מטא-נתונים, וניתן להשתמש בהם כדי לארגן קבצים ב-Google Drive. למאפיינים האלה יש את המאפיינים הבאים:
- תיקייה היא קובץ עם סוג MIME
application/vnd.google-apps.folder
ואין לה סיומת. - אפשר להשתמש בכינוי
root
כדי להפנות לתיקיית השורש בכל מקום שבו מצוין מזהה קובץ.
מידע נוסף על מגבלות התיקיות ב-Drive זמין במאמר מגבלות על קבצים ותיקיות.
במדריך הזה מוסבר איך לבצע כמה משימות בסיסיות שקשורות לתיקיות.
יצירת תיקייה
כדי ליצור תיקייה, משתמשים ב-method files.create()
עם ה-mimeType
של application/vnd.google-apps.folder
ו-name
.
דוגמת הקוד הבאה מראה איך ליצור תיקייה באמצעות ספריית לקוח:
Java
Python
Node.js
PHP
.NET
יצירת קובץ בתיקייה ספציפית
כדי ליצור קובץ בתיקייה ספציפית, משתמשים בשיטה files.create()
ומציינים את מזהה התיקייה במאפיין parents
של הקובץ.
המאפיין parents
מכיל את המזהה של תיקיית ההורה שמכילה את הקובץ.
אפשר להשתמש בנכס parents
כשיוצרים קבצים בתיקייה ברמה העליונה או בכל תיקייה אחרת.
לקובץ יכולה להיות רק תיקיית הורה אחת. אין תמיכה בציינה של כמה הורים. אם לא מציינים את השדה parents
, הקובץ ממוקם ישירות בתיקייה'האחסון שלי' של המשתמש.
דוגמת הקוד הבאה מראה איך יוצרים קובץ בתיקייה ספציפית באמצעות ספריית לקוח:
Java
Python
Node.js
PHP
.NET
העברת קבצים בין תיקיות
כדי להעביר קבצים, צריך לעדכן את המזהה של נכס parents
.
כדי להוסיף או להסיר הורים לקובץ קיים, משתמשים בשיטה files.update()
עם הפרמטרים של השאילתה addParents
ו-removeParents
.
לקובץ יכולה להיות רק תיקיית הורה אחת. אין תמיכה בציינה של כמה הורים.
בדוגמת הקוד הבאה מוסבר איך להעביר קובץ בין תיקיות באמצעות ספריית לקוח:
Java
Python
Node.js
PHP
.NET
מגבלות על קבצים ותיקיות
יש מגבלות אחסון מסוימות על קבצים ותיקיות ב-Drive.
מגבלת פריטים למשתמש
לכל משתמש יכולים להיות עד 500 מיליון פריטים שנוצרו על ידי החשבון הזה. כשהמשתמשים מגיעים למגבלה, הם לא יכולים יותר ליצור או להעלות פריטים ב-Drive. הם עדיין יכולים לראות ולערוך פריטים קיימים. כדי ליצור קבצים מחדש, המשתמשים צריכים למחוק את הפריטים באופן סופי או להשתמש בחשבון אחר. למידע נוסף, ראו העברה לאשפה או מחיקה של קבצים ותיקיות.
האובייקטים שנכללים במגבלה הזו הם:
- פריטים שנוצרו או הועלה על ידי המשתמש ב-Drive
- פריטים שנוצרו על ידי המשתמש אבל עכשיו בבעלות של מישהו אחר
- פריטים באשפה
- קיצורי דרך
- מקשי קיצור של צד שלישי
אובייקטים שלא נספרים במגבלה הזו:
- פריטים שנמחקו לתמיד
- פריטים ששותפו עם המשתמש אבל בבעלות מישהו אחר
- פריטים שנמצאים בבעלות המשתמש אבל נוצרו על ידי מישהו אחר
ניסיונות להוסיף יותר מ-500 מיליון פריטים יחזירו תגובה עם קוד הסטטוס activeItemCreationLimitExceeded
של HTTP.
חשוב לזכור שאין הגבלה על מספר הפריטים שחשבון שירות יכול להיות הבעלים שלהם, אבל המגבלה של 500 מיליון פריטים חלה על מספר הפריטים שחשבון שירות יכול ליצור.
מגבלת פריטים בתיקייה
בכל תיקייה בתיקייה 'האחסון שלי' של משתמש יש מגבלה של 500,000 פריטים. המגבלה הזו לא חלה על תיקיית הבסיס של 'האחסון שלי'. הפריטים הבאים נספרים במסגרת המגבלה הזו:
- תיקיות
- קבצים כל סוגי הקבצים, ללא קשר לבעלות עליהם.
- קיצורי דרך. נספר כפריט יחיד בתיקייה, גם אם הפריט שהוא מפנה אליו לא נמצא בתיקייה הזו. למידע נוסף, ראו יצירת קיצור דרך לקובץ ב-Drive.
- מקשי קיצור של צד שלישי. נספר כפריט יחיד בתיקייה, גם אם הפריט שהוא מפנה אליו לא נמצא בתיקייה הזו. למידע נוסף, ראו יצירת קובץ קיצור דרך לתוכן שנשמר באפליקציה.
מידע נוסף על מגבלות תיקיות זמין במאמר מגבלות תיקיות ב-Google Drive.
מגבלת עומק התיקיות
תיקיית'האחסון שלי' של משתמש לא יכולה להכיל יותר מ-100 רמות של תיקיות בתיקיות. כלומר, אי אפשר לאחסן תיקיית צאצא מתחת לתיקייה שמורכבת מיותר מ-99 רמות. ההגבלה הזו חלה רק על תיקיות צאצא. קובץ צאצא עם סוג MIME שאינו application/vnd.google-apps.folder
פטור מהמגבלה הזו.
לדוגמה, בתרשים הבא אפשר לראות שתיקייה חדשה יכולה להיות בתיקייה מספר 99, אבל לא בתיקייה מספר 100. עם זאת, אפשר לאחסן קבצים בתיקייה מספר 100 כמו בכל תיקייה אחרת ב-Drive:
ניסיונות להוסיף יותר מ-100 רמות של תיקיות יחזירו תגובה עם קוד הסטטוס myDriveHierarchyDepthLimitExceeded
של HTTP.