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

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

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

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

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

משתמשים בשיטה 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 כדי לעקוב אחרי שינויים באחסון שיתופי. בקטע הזה מתוארים שדות ספציפיים לאחסון שיתופי ב-method changes.list. מידע נוסף זמין במאמר מעקב אחרי שינויים במשתמשים ובאחסון השיתופי. השיטה changes.list מכילה את השדות הבאים ואת מצבי השאילתה הספציפיים לאחסון שיתופי:

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

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

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

פרטים נוספים על ההתנהגות של יומני השינויים זמינים במאמר יומני שינויים.

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

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

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

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

השלבים הבאים

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