שילוב עם הלחצן "חדש" בממשק המשתמש של Drive

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

לאחר מכן האפליקציה מקבלת קבוצת ברירת מחדל של משתני תבניות state. ערך ברירת המחדל state הפרטים של כתובת URL חדשה הם:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

הפלט הזה כולל את הערכים הבאים:

• create: הפעולה שמבוצעת. הערך הוא create כשמשתמש לוחץ על האפשרות 'חדש' בממשק המשתמש של Drive .
• FOLDER_ID: המזהה של תיקיית ההורה.
• FOLDER_RESOURCE_KEY: מפתח המשאב של תיקיית ההורה.
• USER_ID: מזהה הפרופיל שמזהה באופן ייחודי את משתמש.

האפליקציה צריכה לפעול בנוגע לבקשה הזו באמצעות השלבים הבאים:

1. מוודאים שהשדה action מכיל את הערך create.
2. כדי ליצור סשן חדש למשתמש, צריך להשתמש בערך userId. לקבלת מידע נוסף מידע על משתמשים מחוברים, ראו משתמשים אירועים חדשים.
3. משתמשים בשיטה files.create כדי ליצור משאב של קובץ. אם בבקשה הוגדר הערך folderId, יש להגדיר את parents לערך של folderId.
4. אם בבקשה הוגדר הערך folderResourceKey, יש להגדיר את כותרת הבקשה X-Goog-Drive-Resource-Keys. מידע נוסף על מפתחות משאבים, ראו גישה לקבצים ששותפו באמצעות קישור באמצעות משאב .

הפרמטר state מקודד בכתובת URL, ולכן האפליקציה חייבת לטפל בתו בריחה (escape) ולנתח אותו כקובץ JSON.

משתמשים ו אירועים חדשים

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