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

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

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

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

Drive API גרסה 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

Drive API גרסה 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 על כך מיועד לטיפול בקבצים בתיקיות אחסון שיתופי.

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

חיפוש תוכן באחסון שיתופי

משתמשים בשיטה files.list כדי לחפש תיקיות אחסון שיתופי. הקטע הזה עוסק בשדות ספציפיים לאחסון שיתופי אמצעי תשלום אחד (files.list). כדי לחפש את האחסון השיתופי צריך לעיין במאמר בנושא חיפוש קבצים ותיקיות

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

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

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

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

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

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

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

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

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

לפרטים נוספים על אופן הפעולה של יומני שינויים: שינוי יומנים.

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

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

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

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

השלבים הבאים

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