כשמשתמש לוחץ על הלחצן 'חדש' בממשק המשתמש של 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: מזהה הפרופיל שמזהה את המשתמש באופן ייחודי.
האפליקציה שלך חייבת לפעול בנוגע לבקשה הזו על ידי ביצוע השלבים הבאים:
- מוודאים שהשדה
action
מכיל את הערךcreate
. - יש להשתמש בערך
userId
כדי ליצור סשן חדש למשתמש. למידע נוסף על משתמשים מחוברים, ראו משתמשים ואירועים חדשים. - משתמשים ב-method
files.create
כדי ליצור משאב קובץ. אם הוגדר הערךfolderId
במסגרת הבקשה, צריך להגדיר בשדהparents
את הערךfolderId
. - אם הוגדר הערך
folderResourceKey
בבקשה, צריך להגדיר את כותרת הבקשהX-Goog-Drive-Resource-Keys
. למידע נוסף על מפתחות משאבים, קראו את המאמר גישה לקבצים משותפים של קישורים באמצעות מפתחות משאבים.
הפרמטר state
מקודד בכתובת ה-URL, לכן האפליקציה צריכה לטפל בתווים המסומנים בתו בריחה ולנתח אותו כקובץ JSON.
משתמשים ואירועים חדשים
אפליקציות Drive צריכות להתייחס לכל אירועי 'יצירה' כאל כניסות פוטנציאליות. לחלק מהמשתמשים יש כמה חשבונות, ולכן ייתכן שמזהה המשתמש בפרמטר state
לא יתאים לסשן הנוכחי. אם ה-User-ID בפרמטר state
לא תואם לסשן הנוכחי, צריך לסיים את הסשן הנוכחי באפליקציה ולהיכנס בתור המשתמש המבוקש.