שילוב עם הלחצן "חדש" בממשק המשתמש של 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 לא תואם לסשן הנוכחי, צריך לסיים את הסשן הנוכחי באפליקציה ולהיכנס כמשתמש המבוקש.