סקירה כללית של הכלי לבחירת קבצים של Google

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

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

‫Google Picker API הוא הממשק הטכני שמשמש להטמעת הכלי לבחירת קבצים של Google באפליקציה. באמצעות Google Picker API, אתם יוצרים ממשק מוכר שמטפל במורכבות של אימות ועיון בקבצים, ומחזיר לאפליקציה מטא-נתונים ספציפיים של קבצים (כמו מזהים וכתובות URL) אחרי שהמשתמש בוחר קובץ.

תרחישי שימוש עיקריים

כלי בחירת הקבצים של Google הוא רב-תכליתי ואפשר להתאים אותו לתהליכי עבודה שונים באפליקציות:

  • חלופה להעלאת קבצים: משתמשים יכולים להעלות קובץ ל-Drive ישירות דרך בורר הקבצים של Google.
  • כלי שיתוף פעולה: מאפשרים למשתמשים לקשר מסמכי Google Docs או גיליונות אלקטרוניים של Google Sheets ספציפיים למשימה בניהול פרויקטים או לאירוע ביומן משותף.
  • קבצים מצורפים של נכסים: אפשר להשתמש בכלי לבחירת קבצים של Google כדי לאפשר למשתמשים לצרף מסמכים תומכים מ-Drive לדוח הוצאות או לכרטיס תמיכה.

השוואה בין אפליקציות אינטרנט לבין אפליקציות למחשב ולאפליקציות לנייד

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

תכונה אפליקציות אינטרנט אפליקציות למחשב ולאפליקציות לנייד
טכנולוגיה ראשית ספריית JavaScript בצד הלקוח. פרמטרים של כתובת URL ב-OAuth 2.0 והפניות אוטומטיות של HTTP.
רינדור הוא משתלב בפריסה של ממשק המשתמש הקיימת של האפליקציה. הקישור ייפתח בכרטיסייה חדשה בדפדפן ברירת המחדל של המשתמש במערכת. כבר לא ניתן להציג אותן ב-WebView מוטמע.
תהליך אימות נדרש טוקן גישה ספציפי שמועבר דרך setOAuthToken. מופעל כשמוסיפים את trigger_onepick=true לבקשת OAuth.
שיטת התגובה קריאות חוזרות (callbacks) ישירות של JavaScript. מזהי URI להפניה אוטומטית או סכימות מותאמות אישית של כתובות URL.
טווחים גמיש; אפשר להשתמש ב-drive.file, ב-drive.readonly וכו'. מחמיר; מותר להשתמש רק ב-drive.file ואי אפשר לשלב אותו עם היקפי הרשאות אחרים.
הגדרות אישיות שימוש בממשק PickerBuilder fluent ב-JavaScript. משתמש בפרמטרים של מחרוזת השאילתה בכתובת ה-URL של ההרשאה.

הערה: כדי להשתמש בהיקף ההרשאות drive.file, המשתמש צריך להיות מחובר לחשבון בזמן הגישה לכלי לבחירת קבצים של Google.

ההבדלים האסטרטגיים העיקריים הם:

  • אפליקציות אינטרנט מיועדות לאינטראקטיביות גבוהה ולהתאמה אישית מעמיקה (לדוגמה, תצוגות ספציפיות לפי סוג הקובץ והגבלת התצוגה לתיקיות ספציפיות ב-Drive).
  • אפליקציות למחשב ולאפליקציות לנייד מתוכננות להיות מאובטחות ופשוטות לשימוש. הן משתמשות בדפדפן המערכת כדי לטפל באימות ובבחירת קבצים בתהליך מאוחד אחד.