דף זה תורגם על ידי Cloud Translation API.

יישום תמיכה באחסון שיתופי

תיקיות האחסון השיתופי מבוססות על מודלים שונים של ארגון, שיתוף ובעלות מ'האחסון שלי'. אם אתם מתכוונים ליצור ולנהל קבצים באחסון שיתופי, עליכם להטמיע בה תמיכה באחסון שיתופי. מורכבות ההטמעה תלויה בפונקציונליות של האפליקציה.

כדי להתחיל, צריך לכלול בבקשות את פרמטר השאילתה supportsAllDrives=true כאשר האפליקציה מבצעת את הפעולות המפורטות בהמשך:

ממשק API של Drive גרסה 3

files.get
files.list
files.create
files.update
files.copy
files.delete
changes.list
changes.getStartPageToken
permissions.list
permissions.get
permissions.create
permissions.update
permissions.delete

ממשק API של Drive גרסה 2

files.get
files.list
files.insert
files.update
files.patch
files.copy
files.trash
files.untrash
files.delete
files.touch
children.insert
parents.insert
changes.list
changes.getStartPageToken
changes.get
permissions.list
permissions.get
permissions.insert
permissions.update
permissions.patch
permissions.delete

הפרמטר supportsAllDrives=true מודיע ל-Google Drive שהאפליקציה שלכם מיועדת לטפל בקבצים בתיקיות אחסון שיתופי.

לאפליקציות שקוראות או משנות הרשאות, עוקבים אחרי שינויים או שצריכות לחפש במספר רב של מאגרים, נדרשת פונקציונליות נוספת של האחסון השיתופי. בהמשך המסמך מתוארים שינויים נוספים שדרושים לצורך ביצוע המשימות האלה.

איך מחפשים תוכן בתיקיית אחסון שיתופי

כדי לחפש תיקיות אחסון שיתופי, משתמשים ב-method files.list. בקטע הזה מפורטים שדות ספציפיים לאחסון שיתופי בשיטה files.list. במאמר חיפוש קבצים ותיקיות אפשר למצוא אחסון שיתופי.

השיטה files.list מכילה את השדות הבאים הספציפיים לאחסון השיתופי ואת מצבי השאילתות הבאים:

driveId — המזהה של האחסון השיתופי לחיפוש.
includeItemsFromAllDrives – האם לכלול פריטים באחסון שיתופי בתוצאות. אם הוא לא נמצא או מוגדר כ-False, הפריטים באחסון השיתופי לא יוחזרו.
corpora – גופי פריטים (קבצים/מסמכים) שהשאילתה חלה עליהם. הגופים הנתמכים הם user, domain, drive ו-allDrives. לצריכת אנרגיה יעילה יותר, עדיף user או drive עד allDrives.
supportsAllDrives – האם האפליקציה שביקשה תמיכה תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי. אם המדיניות הזו מוגדרת כ-False, הפריטים באחסון השיתופי לא נכללים בתגובה.

מצבי השאילתה הבאים ספציפיים לתיקיות אחסון שיתופי:

`includeItemsFromAllDrives`	`corpora`	תיאור השאילתה
`true`	`user`	שליחת שאילתות על קבצים שהמשתמש ניגש אליהם, כולל קבצים באחסון שיתופי וגם בקבצים ב'אחסון שלי'.
`true`	`drive`	שולח שאילתה על כל הפריטים באחסון השיתופי שצוין. יש לציין את מזהה Drive בבקשה.
`true`	`allDrives`	שליחת שאילתות על קבצים שהמשתמש ניגש אליהם ועל כל תיקיות האחסון השיתופי שבהן הוא חבר. לתשומת ליבך, יכול להיות שהתשובה תכלול את `incompleteSearch : true`, סימן לכך שלא בוצע חיפוש לגבי הבקשה הזו.
`true`	`domain`	שולח שאילתות על קבצים ששותפו עם הדומיין, כולל קבצים באחסון שיתופי וגם בקבצים ב'אחסון שלי'.

מעקב אחר שינויים באחסון שיתופי

משתמשים בשיטה changes.list כדי לעקוב אחרי שינויים באחסון שיתופי. בקטע הזה מפורטים שדות ספציפיים לאחסון שיתופי בשיטה changes.list. מידע נוסף זמין במאמר מעקב אחרי שינויים של משתמשים ושל תיקיות אחסון שיתופי. השיטה changes.list מכילה את השדות הבאים הספציפיים לאחסון השיתופי ואת מצבי השאילתות הבאים:

driveId - האחסון השיתופי שממנו מוחזרים השינויים. אם ציינו שינויים, מזהי השינויים מתייחסים לשינויים באחסון השיתופי, ולא לשינויים בקבצים המוצגים למשתמש. כדי להפנות לשינוי ספציפי באחסון שיתופי, צריך להשתמש גם במזהה של האחסון השיתופי וגם במזהה השינוי כמזהה.
supportsAllDrives – האם האפליקציה שביקשה תומכת בתיקיות אחסון שיתופי. אם הערך הוא False, לא מוחזרים פריטים באחסון השיתופי, כולל תיקיות אחסון שיתופי וקבצים שנמצאים בתוך אחסון שיתופי.
includeItemsFromAllDrives – האם קבצים או שינויים באחסון השיתופי צריכים להיכלל ברשימת השינויים.

מצבי השאילתה הבאים ספציפיים לתיקיות אחסון שיתופי:

`includeItemsFromAllDrives`	`driveId`	תיאור השאילתה
`true`	לא	השינויים משקפים שינויים בקבצים בתוך תיקיות אחסון שיתופי או מחוצה להן, ועל שינויים בתיקיות אחסון שיתופי שהמשתמש חבר בהן.
`true`	כן	השינויים משקפים שינויים באחסון השיתופי הספציפי שצוין ובפריטים שנכללים באותו אחסון שיתופי.

במאמר Change Logs מפורט מידע נוסף על ההתנהגות של יומן השינויים.

הפעלת תמיכה באחסון שיתופי בממשק המשתמש של Drive

כדי לגשת לתוכן באחסון שיתופי באמצעות ממשק המשתמש של Drive, חשוב לסמן את האפשרות 'תמיכה בתיקיות אחסון שיתופי' במסוף Google API. למידע נוסף קראו את המאמר הגדרת שילוב עם ממשק משתמש של Drive.

שימוש בכלי לבחירת קבצים עם תיקיות אחסון שיתופי

אפשר לבחור פריטים מתיקיות אחסון שיתופי בכלי לבחירת קבצים. במאמר Google Picker API אפשר לקרוא מידע נוסף על הפעלת התמיכה בתיקיות אחסון שיתופי והוספה של תצוגת תיקיות אחסון שיתופי בכלי לבחירת קבצים.

השלבים הבאים

לקבלת עזרה ביצירת תיקיות אחסון שיתופי ובניהול הרשאות של תיקיות אחסון שיתופי, קראו את המאמר ניהול תיקיות אחסון שיתופי.