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

כשמשתמש לוחץ על הלחצן 'חדש' בממשק המשתמש של Drive ובוחר אפליקציה בממשק המשתמש של Drive, Drive מפנה את המשתמש לכתובת האתר החדשה של האפליקציה, שהוגדרה בהגדרת שילוב של ממשק משתמש ב-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, ולכן האפליקציה צריכה לטפל בתווים בריחה (escape) ולנתח אותו כ-JSON.

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

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