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

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

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

השלבים הבאים

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