כשמשתמש בוחר קובץ ולוחץ על הפריט 'פתיחה באמצעות' בממשק המשתמש של Drive, מערכת Drive מפנה את המשתמש לכתובת URL פתוחה של האפליקציה שהוגדרה בהגדרת שילוב של ממשק משתמש ב-Drive.
אם סימנתם את התיבה Importing כשהגדרתם את השילוב של ממשק המשתמש ב-Drive, המשתמש יכול לבחור שילוב של קבצים ספציפיים לאפליקציה וקובצי Google Workspace לפתיחה. כשמגדירים שילוב בממשק המשתמש של Drive, קבצים ספציפיים לאפליקציה מוגדרים בשדות "ברירת מחדל של MIME לקבצים" ו"סיומות ברירת מחדל של קבצים", ואילו קובצי Google Workspace מוגדרים בשדות "סוגי MIME משניים" ו "סיומות קובץ משניות".
לכל קובץ שהמשתמש רוצה לפתוח, Drive בודק את סוגי ה-MIME לעומת סוגי ה-MIME המשניים וברירת המחדל שהגדרתם:
בסוגי MIME שמוגדרים בשדה Default MIME types, מזהה הקובץ מועבר לאפליקציה. למידע על אופן הטיפול בקבצים ספציפיים לאפליקציה, קראו את המאמר טיפול בכתובת URL פתוחה למסמכים ספציפיים לאפליקציה.
לסוגי MIME שמוגדרים בשדה 'סוגי MIME משניים', בממשק המשתמש של Drive מוצגת תיבת דו-שיח ששואלת את המשתמשים לאיזה סוג קובץ להמיר את הקובץ ב-Google Workspace. לדוגמה, אם בחרת קובץ של Google Docs בממשק המשתמש של Drive, והשדה 'סוגי MIME משניים' מציין שהאפליקציה תומכת בטקסט/רגיל או באפליקציה/pdf, ממשק המשתמש של Drive ישאל את המשתמשים אם הם רוצים להמיר לטקסט פשוט או ל-PDF.
למידע נוסף על הטיפול בקובצי Google Workspace, תוכלו לקרוא את המאמר טיפול בכתובת URL פתוחה במסמכי Google Workspace. רשימה של מסמכי Google Workspace ופורמטים של המרות מסוג MIME זמינה במאמר ייצוא סוגי MIME למסמכי Google Workspace.
טיפול בכתובת URL פתוחה עבור מסמכים ספציפיים לאפליקציה
כפי שצוין במאמר הגדרת שילוב בממשק המשתמש של Drive, האפליקציה מקבלת משתנים של תבניות עם מידע שיאפשר לאפליקציה לפתוח את הקובץ. האפליקציה מקבלת קבוצת ברירת מחדל של משתני תבנית בתוך פרמטר state
. פרטי ברירת המחדל של state
ל-Open URL ספציפי לאפליקציה הם:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
הפלט הזה כולל את הערכים הבאים:
- ID: המזהה של תיקיית ההורה.
- RESOURCE_KEYS: מילון JSON של מזהי קבצים שממופים למפתחות המשאבים המתאימים.
open
: הפעולה שמבוצעת. הערך הואopen
כשמשתמשים בכתובת URL פתוחה.- USER_ID: מזהה הפרופיל שמזהה את המשתמש באופן ייחודי.
האפליקציה שלך חייבת לפעול לגבי הבקשה הזו באמצעות השלבים הבאים:
- מוודאים שהשדה
action
מכיל את הערךopen
ושהשדהids
קיים. - יש להשתמש בערך
userId
כדי ליצור סשן חדש עבור המשתמש. מידע נוסף על משתמשים שמחוברים לחשבון זמין במאמר משתמשים ואירועים חדשים. - משתמשים בשיטה
files.get
כדי לבדוק הרשאות, לאחזר מטא-נתונים של קבצים ולהוריד את תוכן הקובץ באמצעות ערכיID
. - אם הוגדר הערך
resourceKeys
בבקשה, מגדירים את כותרת הבקשהX-Goog-Drive-Resource-Keys
. מידע נוסף על מפתחות משאבים מופיע במאמר גישה לקבצים ששותפו על ידי קישורים באמצעות מפתחות משאבים.
הפרמטר state
מקודד בכתובת URL, ולכן האפליקציה צריכה לטפל בתווים
בריחה (escape) ולנתח אותו כ-JSON.
טיפול בכתובת URL פתוחה למסמכי Google Workspace
כפי שצוין במאמר הגדרת שילוב בממשק המשתמש של Drive, האפליקציה שלכם מקבלת קבוצת ברירת מחדל של משתני תבנית בתוך פרמטר state
. פרטי ברירת המחדל של state
לכתובת URL פתוחה ב-Google Workspace הם:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
הפלט הזה כולל את הערכים הבאים:
- EXPORT_ID: רשימה של מזהי קבצים שמיוצאים, כשהם מופרדים בפסיקים (משמשת רק לפתיחת מסמכים מובנים של Google).
- RESOURCE_KEYS: מילון JSON של מזהי קבצים שממופים למפתחות המשאבים המתאימים.
open
: הפעולה שמבוצעת. הערך הואopen
כשמשתמשים בכתובת URL פתוחה.- USER_ID: מזהה הפרופיל שמזהה את המשתמש.
האפליקציה שלך חייבת לפעול לגבי הבקשה הזו באמצעות השלבים הבאים:
כדי לוודא שזו בקשה לפתיחת קובץ, צריך לזהות את הערך
open
בשדהstate
וגם את הנוכחות של השדהexportIds
.משתמשים בשיטה
files.get
כדי לבדוק הרשאות, לאחזר מטא-נתונים של קבצים ולזהות את סוג ה-MIME באמצעות הערכים שלEXPORT_ID
.ממירים את תוכן הקובץ באמצעות ה-method
files.export
. בדוגמת הקוד הבאה מוסבר איך לייצא מסמך של Google Workspace לסוג ה-MIME המבוקש.אם הוגדר הערך
resourceKey
בבקשה, מגדירים את כותרת הבקשהX-Goog-Drive-Resource-Keys
. מידע נוסף על מפתחות משאבים מופיע במאמר גישה לקבצים ששותפו על ידי קישורים באמצעות מפתחות משאבים.Java
Python
Node.js
PHP
אפשר להציג את הקבצים שהומרו לקריאה בלבד או להציג תיבת דו-שיח שמאפשרת למשתמש לשמור את הקובץ בתור סוג הקובץ החדש.
הפרמטר state
מקודד בכתובת URL, ולכן האפליקציה צריכה לטפל בתווים
בריחה (escape) ולנתח אותו כ-JSON.
משתמשים ואירועים חדשים
אפליקציות Drive צריכות להתייחס לכל אירועי 'פתיחה באמצעות' כאל כניסות פוטנציאליות. לחלק מהמשתמשים עשויים להיות כמה חשבונות, ולכן ייתכן שמזהה המשתמש בפרמטר state
לא יתאים לסשן הנוכחי. אם מזהה המשתמש בפרמטר state
לא תואם לסשן הנוכחי, יש לסיים את הסשן הנוכחי באפליקציה ולהיכנס בתור המשתמש המבוקש.
נושאים קשורים
בנוסף לפתיחת אפליקציה מממשק המשתמש של Google Drive, האפליקציות יכולות להציג בוחר קבצים לבחירת תוכן מתוך האפליקציה. למידע נוסף, עיינו בבוחר Google.