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

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

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