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

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

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

Drive API v3

  • 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 v2

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

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

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

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

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

  • ‫driveId: המזהה של האחסון השיתופי שרוצים לחפש בו.

  • ‫corpora: גופי הפריטים (קבצים או מסמכים) שהשאילתה חלה עליהם. הגופים הנתמכים הם user,‏ domain,‏ drive ו-allDrives. עדיף להשתמש ב-user או ב-drive במקום ב-allDrives כדי לחסוך באנרגיה. כברירת מחדל, ההגדרה של מאגרי המידע היא user.

  • ‫includeItemsFromAllDrives: האם לכלול בתוצאות פריטים מ'האחסון שלי' ומאחסון שיתופי. אם המאפיין לא מוגדר או מוגדר כ-False, לא יוחזרו פריטים באחסון השיתופי.

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

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

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

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

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

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

  • ‫driveId: האחסון השיתופי שממנו מוחזרים השינויים. אם מציינים, מזהי השינויים מתייחסים לשינויים בפריטים באחסון השיתופי, ומספקים את המצב הנוכחי של הקובץ. כדי להתייחס לשינוי ספציפי באחסון השיתופי, צריך להשתמש במזהה האחסון השיתופי ובמזהה השינוי כמזהים.

  • ‫includeItemsFromAllDrives: האם לכלול ברשימת השינויים קבצים או שינויים בתיקיות אחסון שיתופי.

  • ‫supportsAllDrives: האם האפליקציה ששלחה את הבקשה תומכת באחסון שיתופי. אם הערך הוא false, לא מוחזרים פריטים באחסון שיתופי, כולל תיקיות אחסון שיתופי וקבצים בתוך אחסון שיתופי.

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

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

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

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

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

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

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