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

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

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

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

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

משתמשים בשיטה 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 שולחת שאילתות לכל הפריטים בתיקיית האחסון השיתופי שצוינה. צריך לציין את driveId בבקשה.
true allDrives שאילתות לגבי קבצים שהמשתמש נכנס אליהם ולכל תיקיות האחסון השיתופי שבהן הוא חבר. שימו לב שהתגובה עשויה לכלול את הערך incompleteSearch : true, שמציין שלא בוצע חיפוש בחלק מהקורפוסים עבור הבקשה הזו.
true domain שאילתות לגבי קבצים ששותפו עם הדומיין, כולל קבצים בתיקיות אחסון שיתופי וקבצים בתיקייה 'האחסון שלי'.

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

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

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

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

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

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

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

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

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

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

השלבים הבאים

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