במסמך הזה מפורטות משימות שקשורות לניהול תיקיות באחסון השיתופי, כמו יצירת תיקיות באחסון השיתופי וניהול חברים והרשאות, באמצעות Google Drive API.
אם רוצים לציין את השדות שיוחזרו בתגובה, אפשר להגדיר את fields פרמטר המערכת בכל שיטה של משאב drives. אם לא מציינים את הפרמטר fields, השרת מחזיר קבוצת שדות שמוגדרת כברירת מחדל וספציפית לשיטה. לדוגמה, השיטה list מחזירה רק את השדות kind, id ו-name של כל תיקיית אחסון שיתופי. מידע נוסף זמין במאמר בנושא החזרת שדות ספציפיים.
מידע נוסף על מגבלות על תיקיות באחסון שיתופי זמין במאמר מגבלות על תיקיות באחסון שיתופי.
דרישות מוקדמות
כדי ליצור תיקיות באחסון השיתופי ולנהל אותן, צריך לוודא שאתם עומדים בדרישות הבאות:
- חשבון Google Workspace: תיקיות משותפות זמינות במהדורות נתמכות של Google Workspace (כמו Business Standard, Business Plus, Enterprise ו-Education). בחשבונות Google אישיים (
@gmail.com) אי אפשר ליצור תיקיות אחסון שיתופי. - הרשאת יצירה: אדמינים של דומיין יכולים להגדיר אם משתמשים בארגון שלהם יכולים ליצור תיקיות אחסון שיתופי. המשתמש המאומת צריך להשתייך ליחידה ארגונית שיש לה הרשאה ליצור תיקיות אחסון שיתופי.
- היקף הרשאות OAuth 2.0: האפליקציה צריכה לקבל הרשאה עם היקף ההרשאות
https://www.googleapis.com/auth/drive. - תפקידים: כשמשתמש יוצר אחסון שיתופי, הוא מקבל באופן אוטומטי את התפקיד
organizerבאחסון השיתופי הזה. כדי לנהל את ההגדרות של האחסון השיתופי, לשנות את השם שלו, להוסיף או להסיר חברים ולמחוק את האחסון השיתופי, צריך להיות בעלי תפקידorganizer. מידע נוסף על תפקידים זמין במאמר תפקידים בתיקיות משותפות. - גישה של אדמין בדומיין: אדמינים בדומיין יכולים לנהל כל תיקיית אחסון שיתופי בארגון שלהם, בלי קשר לחברות שלהם בה, על ידי העברת
useDomainAdminAccess=true. מידע נוסף זמין במאמר בנושא ניהול של תיקיות משותפות כאדמינים של הדומיין.
יצירת אחסון שיתופי
כדי ליצור אחסון שיתופי, משתמשים בשיטה create במשאב drives עם הפרמטר requestId.
הפרמטר requestId מזהה את הניסיון הלוגי ליצירה אידמפוטנטית של אחסון שיתופי. אם פג הזמן הקצוב לתגובה לבקשה או שהבקשה מחזירה שגיאת קצה עורפי לא מוגדרת, אפשר לשלוח את אותה בקשה שוב ולא ייווצרו כפילויות. ה-requestId וגוף הבקשה צריכים להישאר ללא שינוי.
בדוגמת הקוד הבאה אפשר לראות איך יוצרים תיקייה באחסון השיתופי:
Java
Python
Node.js
PHP
.NET
הקריאות לשיטה create הן אידמפוטנטיות.
אם האחסון השיתופי נוצר בהצלחה בבקשה קודמת או בעקבות ניסיון חוזר, הפונקציה מחזירה מופע של משאב drives. לפעמים, למשל
אחרי זמן ממושך או אם גוף הבקשה השתנה, יכול להיות שתוחזר 409
שגיאה שמציינת שצריך לבטל את requestId.
קבלת אחסון שיתופי
כדי לקבל מטא-נתונים של תיקיית אחסון שיתופי, משתמשים בשיטה get במשאב drives עם פרמטר הנתיב driveId. אם אתם לא יודעים את מזהה ה-Drive, אתם יכולים לרשום את כל תיקיות האחסון השיתופי באמצעות method list.
השיטה get מחזירה אחסון שיתופי כמופע של משאב drives.
כדי להגיש את הבקשה כאדמין של הדומיין, צריך להגדיר את פרמטר השאילתה useDomainAdminAccess
לערך true. מידע נוסף זמין במאמר בנושא ניהול תיקיות אחסון שיתופי כאדמינים של הדומיין.
רשימת תיקיות אחסון שיתופי
כדי להציג רשימה של תיקיות אחסון שיתופי של משתמש, משתמשים בשיטה list במשאב drives. השיטה מחזירה רשימה של תיקיות אחסון שיתופי.
כדי להתאים אישית את המספור של תיקיות אחסון שיתופי או לסנן אותן, צריך להעביר את פרמטרי השאילתה הבאים:
pageSize: המספר המקסימלי של תיקיות באחסון השיתופי שיוחזרו בכל דף.
pageToken: טוקן של דף שהתקבל מקריאה קודמת של list. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.
q: מחרוזת שאילתה לחיפוש בכונני אחסון שיתופיים. מידע נוסף זמין במאמר בנושא חיפוש תיקיות באחסון השיתופי.
useDomainAdminAccess: צריך להגדיר את הערךtrueכדי לשלוח את הבקשה כמנהל דומיין, וכך לקבל את כל תיקיות האחסון השיתופי בדומיין שבו השולח הוא מנהל. מידע נוסף זמין במאמר בנושא ניהול של תיקיות משותפות כאדמינים של הדומיין.
עדכון אחסון שיתופי
כדי לעדכן את המטא-נתונים של אחסון שיתופי, משתמשים בשיטה update במשאב drives עם פרמטר הנתיב driveId.
השיטה מחזירה אחסון שיתופי כמופע של משאב drives.
כדי להגיש את הבקשה כאדמין של הדומיין, צריך להגדיר את פרמטר השאילתה useDomainAdminAccess
לערך true. מידע נוסף זמין במאמר בנושא ניהול תיקיות אחסון שיתופי כאדמינים של הדומיין.
הסתרה וביטול הסתרה של אחסון שיתופי
כדי להסתיר אחסון שיתופי מהתצוגה שמוגדרת כברירת מחדל, משתמשים בשיטה hide במשאב drives עם הפרמטר driveId.
כשמסתירים אחסון שיתופי, הוא מסומן ב-Drive כhidden=true. תיקיות אחסון שיתופי מוסתרות לא מופיעות בממשק המשתמש של Drive או ברשימת הקבצים שמוחזרים.
כדי לשחזר תיקיית אחסון שיתופי לתצוגת ברירת המחדל, משתמשים בשיטה unhide במשאב drives עם הפרמטר driveId.
שתי השיטות מחזירות אחסון שיתופי כמופע של משאב drives.
מחיקת אחסון שיתופי
כדי למחוק אחסון שיתופי באופן סופי, משתמשים בשיטה delete במשאב drives עם הפרמטר driveId.
לפני שמוחקים אחסון שיתופי, צריך להעביר את כל התוכן שבו לאשפה או למחוק אותו. למשתמש צריכות להיות גם הרשאות role=organizer בתיקייה באחסון השיתופי. מידע נוסף זמין במאמר בנושא העברה של קבצים ותיקיות לאשפה או מחיקה שלהם.
מעבירים את הפרמטרים הבאים של השאילתה:
useDomainAdminAccess: מגדירים את הערך ל-trueכדי לשלוח את הבקשה בתור אדמין של הדומיין. מידע נוסף זמין במאמר בנושא ניהול תיקיות אחסון שיתופי כאדמינים של הדומיין.
allowItemDeletion: מוגדר כ-trueכדי למחוק פריטים בתיקיית האחסון השיתופי. המאפיין הזה נתמך רק אם המאפייןuseDomainAdminAccessמוגדר גם הוא לערךtrue.
הוספה או הסרה של חברים באחסון השיתופי
מוסיפים חברים לאחסון השיתופי או מסירים אותם ממנו באמצעות מקור המידע permissions.
כדי להוסיף חבר, צריך ליצור את ההרשאה באחסון השיתופי. אפשר גם להשתמש בשיטות להענקת הרשאות לקבצים בודדים בתיקיית אחסון שיתופי, כדי להעניק לחברים הרשאות נוספות או לאפשר למי שלא חברים בתיקייה לשתף פעולה בפריטים ספציפיים.
מידע נוסף וקוד לדוגמה זמינים במאמר בנושא שיתוף קבצים, תיקיות ו-Drive.
ניהול של תיקיות אחסון שיתופי כאדמינים של הדומיין
אפשר להשתמש בפרמטר useDomainAdminAccess עם המשאבים drives ו-permissions כדי לנהל תיקיות באחסון השיתופי בכל הארגון.
משתמשים שמפעילים את השיטות האלה עם useDomainAdminAccess=true צריכים להיות בעלי הרשאת אדמין של Drive and Docs.
אדמינים יכולים לחפש תיקיות באחסון השיתופי או לעדכן הרשאות לתיקיות באחסון השיתופי שנמצאות בבעלות הארגון, ללא קשר לחברות של האדמין בתיקייה מסוימת באחסון השיתופי.
כשמשתמשים בחשבונות שירות, יכול להיות שיהיה צורך להתחזות לאדמין מאומת באמצעות התחזות לחשבון שירות. חשוב לזכור: חשבונות שירות לא שייכים לדומיין שלכם ב-Google Workspace, בניגוד לחשבונות משתמשים. אם אתם משתפים נכסים ב-Google Workspace, כמו מסמכים או אירועים, ברמת הדומיין ב-Google Workspace, הם לא ישותפו עם חשבונות שירות. מידע נוסף מופיע במאמר סקירה כללית על חשבונות שירות.
שחזור של אחסון שיתופי שאין לו מארגן
בדוגמת הקוד הבאה אפשר לראות איך לשחזר תיקיות באחסון השיתופי שכבר אין להן מארגן.
Java
Python
Node.js
PHP
.NET
איך מונעים ממשתמשים להוריד, להדפיס או להעתיק קבצים
אתם יכולים להגביל את האופן שבו משתמשים יכולים להוריד, להדפיס ולהעתיק קבצים באחסון שיתופי.
כדי לבדוק אם המשתמש יכול לשנות הגבלות על הורדה שהוגדרו על ידי המארגן בתיקיית אחסון שיתופי, בודקים את השדה הבוליאני capabilities.canChangeDownloadRestriction. אם הערך של capabilities.canChangeDownloadRestriction הוא true, אפשר להחיל הגבלות על ההורדה של קבצים מהאחסון השיתופי. מידע נוסף זמין במאמר בנושא הסבר על יכולות הקבצים.
המשאב drives מכיל אוסף של שדות בוליאניים restrictions שמשמשים לציון האם אפשר לבצע פעולה באחסון שיתופי.
ההגבלות חלות על אחסון שיתופי או על פריטים בתוך אחסון שיתופי.
אפשר להגדיר הגבלות באמצעות ה-method 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.canChangeCopyRequiresWriterPermissionRestriction |
האם המשתמש הנוכחי יכול לשנות את ההגבלה 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.
נושאים קשורים
- סקירה כללית על תיקיות אחסון שיתופי
- הטמעת תמיכה באחסון שיתופי
- מגבלות שימוש
- מגבלות על קבצים ועל תיקיות ב-Files
- תפקידים והרשאות