שילוב עם הלחצן "חדש" בממשק המשתמש של 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. משתמשים ב-method‏ files.create כדי ליצור משאב קובץ. אם הערך folderId הוגדר בבקשה, צריך להגדיר את השדה parents לערך folderId.
4. אם הכותרת folderResourceKey הוגדרה בבקשה, מגדירים את כותרת הבקשה X-Goog-Drive-Resource-Keys. מידע נוסף על מפתחות משאבים זמין במאמר גישה לקבצים ששותפו באמצעות קישור באמצעות מפתחות משאבים.

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

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

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