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