במדריך הזה מפורטות משימות שקשורות לניהול תיקיות באחסון השיתופי, כמו יצירת תיקיות באחסון השיתופי וניהול של חברים והרשאות, באמצעות Google Drive API.
מידע נוסף על מגבלות על תיקיות באחסון שיתופי זמין במאמר מגבלות על תיקיות.
יצירת אחסון שיתופי
כדי ליצור אחסון שיתופי, משתמשים ב-method drives.create
.
Java
Python
Node.js
PHP
.NET
הקריאות לשיטה drives.create
הן אידמפוטנטיות.
הפרמטר requestId
מזהה את הניסיון הלוגי ליצור את הכונן המשותף. אם פג הזמן הקצוב לתגובה לבקשה או שהבקשה מחזירה שגיאת קצה עורפי לא מוגדרת, אפשר לשלוח את אותה בקשה שוב. הכותרת requestId
והגוף של הבקשה צריכים להישאר זהים.
אם האחסון השיתופי נוצר בהצלחה בבקשה קודמת או בגלל ניסיון חוזר, התשובה הרגילה מוחזרת. לפעמים, למשל אחרי פרק זמן ממושך או אם גוף הבקשה השתנה, יכול להיות שתוחזר שגיאה 409
שמציינת שצריך לבטל את requestId
.
הוספה או הסרה של חברים בתיקיית אחסון שיתופי
מוסיפים חברים לאחסון השיתופי או מסירים אותם ממנו באמצעות מקור המידע permissions
.
כדי להוסיף חבר, צריך ליצור את ההרשאה באחסון השיתופי. אפשר גם להשתמש בשיטות להענקת הרשאות בקבצים בודדים בתיקיית אחסון שיתופי כדי להעניק לחברים הרשאות נוספות או לאפשר למי שלא חברים בתיקייה לערוך פריטים ספציפיים.
מידע נוסף וקוד לדוגמה זמינים במאמר שיתוף קבצים, תיקיות ותיקיות אחסון שיתופי.
מחיקת אחסון שיתופי
כדי למחוק תיקייה משותפת, צריך להשתמש בשיטה drives.delete
. כדי למחוק את האחסון השיתופי, צריך להעביר את כל התוכן שבו לאשפה או למחוק אותו.
ניהול של תיקיות אחסון שיתופי עבור אדמינים בדומיין
כדי לנהל תיקיות באחסון השיתופי בכל הארגון, משתמשים בפרמטר useDomainAdminAccess
עם המשאבים drives
ו-permissions
.
למשתמשים שמבצעים קריאות לשיטות האלה עם useDomainAdminAccess=true
צריכה להיות הרשאת אדמין.Drive and Docs
אדמינים יכולים לחפש תיקיות באחסון השיתופי או לעדכן הרשאות לתיקיות באחסון השיתופי שנמצאות בבעלות הארגון שלהם, ללא קשר לחברות של האדמין בתיקייה מסוימת באחסון השיתופי.
שחזור של אחסון שיתופי שאין לו מארגן
בדוגמה הבאה אפשר לראות איך משתמשים במשאבים האלה כדי לשחזר תיקיות באחסון השיתופי שכבר אין להן מארגן.
Java
Python
Node.js
PHP
.NET
איך מונעים ממשתמשים להוריד, להדפיס או להעתיק את הקובץ
אתם יכולים להגביל את האופן שבו משתמשים יכולים להוריד, להדפיס ולהעתיק קבצים באחסון השיתופי.
כדי לקבוע אם המשתמש יכול לשנות הגבלות על הורדה שהוגדרו על ידי המארגן באחסון שיתופי, בודקים את השדה הבוליאני capabilities.canChangeDownloadRestriction
. אם
capabilities.canChangeDownloadRestriction
מוגדר כ-true
, אפשר להחיל הגבלות על ההורדה של האחסון השיתופי. מידע נוסף זמין במאמר בנושא הסבר על יכולות הקבצים.
המשאב drives
מכיל אוסף של שדות בוליאניים restrictions
שמשמשים לציון האם אפשר לבצע פעולה באחסון שיתופי.
ההגבלות חלות על אחסון שיתופי או על פריטים בתוך אחסון שיתופי.
אפשר להגדיר הגבלות באמצעות השיטה drives.update
.
כדי להחיל הגבלות על הורדה באחסון שיתופי, מנהל האחסון השיתופי יכול להגדיר את השדה restrictions.downloadRestriction
של מקור המידע drives
באמצעות האובייקט DownloadRestriction
.
הגדרת restrictedForReaders
השדה הבוליאני לערך true
מציינת שגם ההורדה וגם ההעתקה מוגבלות לקוראים. הגדרת restrictedForWriters
שדה בוליאני לערך true
מציינת שגם ההורדה וגם ההעתקה מוגבלות למשתמשים עם הרשאת כתיבה. שימו לב: אם השדה restrictedForWriters
הוא true
, גם הורדה והעתקה מוגבלות לקוראים. באופן דומה, הגדרת restrictedForWriters
ל-true
והגדרת restrictedForReaders
ל-false
שוות להגדרת restrictedForWriters
ו-restrictedForReaders
ל-true
.
תאימות לאחור
עם ההשקה של אובייקט DownloadRestriction
, הפונקציונליות של השדה הבוליאני restrictions.copyRequiresWriterPermission
עודכנה.
עכשיו, הגדרת restrictions.copyRequiresWriterPermission
ל-true
מעדכנת את השדה הבוליאני restrictedForReaders
של האובייקט DownloadRestriction
ל-true
כדי להצהיר שגם ההורדה וגם ההעתקה מוגבלות עבור בעלי הרשאת קריאה.
הגדרת השדה copyRequiresWriterPermission
ל-false
מעדכנת את השדות restrictedForWriters
ו-restrictedForReaders
ל-false
. המשמעות היא שהגדרות ההגבלה על הורדה או העתקה יוסרו עבור כל המשתמשים.
שדות ששולטים בתכונות ההורדה, ההדפסה וההעתקה
בטבלה הבאה מפורטים שדות המשאבים drives
שמשפיעים על הפונקציות של הורדה, הדפסה והעתקה:
שדה | תיאור | גרסה |
---|---|---|
capabilities.canCopy |
האם המשתמש הנוכחי יכול להעתיק קבצים באחסון שיתופי. | גרסה 2 וגרסה 3 |
capabilities.canDownload |
האם המשתמש הנוכחי יכול להוריד קבצים באחסון השיתופי. | גרסה 2 וגרסה 3 |
capabilities.canChangeCopyRequiresWriterPermission |
האם המשתמש הנוכחי יכול לשנות את ההגבלה copyRequiresWriterPermission של תיקיית אחסון שיתופי. |
גרסה 2 וגרסה 3 |
capabilities.canResetDriveRestrictions |
האם המשתמש הנוכחי יכול לאפס את ההגבלות של האחסון השיתופי להגדרות ברירת המחדל. | גרסה 2 וגרסה 3 |
capabilities.canChangeDownloadRestriction |
האם המשתמש הנוכחי יכול לשנות את הגבלת ההורדה של תיקיית אחסון שיתופי. | גרסה 3 בלבד |
restrictions.copyRequiresWriterPermission |
האם האפשרויות להעתקה, להדפסה או להורדה של קבצים בתוך אחסון שיתופי מושבתות למשתמשים עם הרשאת קריאה והרשאת תגובה. אם true , השדה עם השם הדומה מוגדר ל-true לכל קובץ באחסון השיתופי הזה. |
גרסה 2 וגרסה 3 |
restrictions.downloadRestriction |
הגבלות ההורדה שמוחלות על ידי מנהלים של אחסון שיתופי. | גרסה 3 בלבד |
מגבלות על תיקיות
יש מגבלות אחסון מסוימות לתיקיות באחסון השיתופי. מידע נוסף זמין במאמר מגבלות על אחסון שיתופי ב-Google Drive.
מכסת פריטים
בכל תיקייה באחסון השיתופי של המשתמש יש מגבלה של 500,000 פריטים, כולל קבצים, תיקיות וקיצורי דרך.
כשהמכסה תיגמר, לא תהיה אפשרות להוסיף פריטים לאחסון השיתופי. כדי לקבל שוב את הקבצים, המשתמשים צריכים למחוק את הפריטים מהתיקייה באופן סופי. הערה: פריטים באשפה נספרים במגבלה, אבל פריטים שנמחקו סופית לא נספרים. מידע נוסף מופיע במאמר העברה לאשפה או מחיקה של קבצים ותיקיות.
מגבלת העומק של תיקייה
תיקייה באחסון שיתופי לא יכולה להכיל יותר מ-100 רמות של תיקיות מקוננות. כלומר, אי אפשר לאחסן תיקיית צאצא בתיקייה שנמצאת ברמה עמוקה יותר מ-99. ההגבלה הזו חלה רק על תיקיות צאצא.
ניסיונות להוסיף יותר מ-100 רמות של תיקיות מחזירים תגובה עם קוד סטטוס HTTP teamDriveHierarchyTooDeep
.