גישה לקובצי Drive ששותפו באמצעות קישור באמצעות מפתחות משאבים

אתם יכולים לשתף קבצים ותיקיות ב-Google Drive עם אחרים באמצעות ממשק המשתמש של Drive או דרך Google Drive API. כשמשתפים קובץ מ-Drive, אפשר לקבוע אם אותם אנשים יוכלו לערוך את הקובץ, להגיב עליו או רק לפתוח אותו.

מפתח משאב עוזר להגן על הקובץ מפני גישה לא מכוונת. מפתחות משאבים הם פרמטר נוסף שמועבר כדי שמשתמשים יוכלו לגשת לקבצים מסוימים ששותפו באמצעות קישור. משתמשים שלא צפו בקובץ בעבר יצטרכו לספק את קוד הגישה כדי לקבל גישה. אנשים שצפו בקובץ לאחרונה או שיש להם גישה ישירה אליו לא צריכים את קוד הגישה כדי לגשת לקובץ.

רק משתמשים שיכולים לגשת לקובץ ב-Drive שמשותף עם קישור יכולים לראות אותו באמצעות משאב type=user או type=group permissions. בקשות ממשתמשים שיש להם גישה רק לקבצים האלו ששותפו באמצעות קישור באמצעות ההרשאה type=domain או type=anyone, עשויות לדרוש מפתח משאב.

מידע נוסף על הרשאות זמין במאמר שיתוף קבצים, תיקיות ואחסון. רשימה מלאה של התפקידים והפעולות שמותר לבצע בכל אחד מהם מופיעה במאמר תפקידים והרשאות.

קריאת מפתח המשאב מהקובץ

‏Drive API מחזיר את מפתח המשאב של הקובץ בשדה resourceKey לקריאה בלבד של המשאב files.

אם הקובץ הוא קיצור דרך ב-Drive, מפתח המשאב של היעד של קיצור הדרך מוחזר בשדה shortcutDetails.targetResourceKey לקריאה בלבד.

שדות במשאב files שמחזירים כתובות URL, כמו exportLinks,‏ webContentLink ו-webViewLink, כוללים גם את resourceKey. לקוחות שמשתלבים בממשק המשתמש של Drive יכולים גם להשתמש ב-resourceKeys בתוך הפרמטר state. למידע נוסף, ראו הורדה וייצוא של קבצים.

הגדרת מפתח המשאב בבקשה

מפתחות המשאבים של קבצים שמצוינים בבקשות ל-Drive API מוגדרים בכותרת ה-HTTP ‏X-Goog-Drive-Resource-Keys.

בבקשות ל-Drive API אפשר לציין מפתח משאב אחד או יותר באמצעות כותרת ה-HTTP ‏X-Goog-Drive-Resource-Keys.

תחביר

מזהה קובץ וזוג מפתחות של משאבים מוגדרים בכותרת באמצעות מפריד קו נטוי (/). הכותרת נוצרת על ידי שילוב של כל מזהי הקבצים וזוגות מפתחות המשאבים באמצעות תווים מפרידים (,).

לדוגמה, נניח שקיבלתם בקשה להעביר את הקובץ fileId1 מהתיקייה fileId2 לתיקייה fileId3. נניח שמפתחות המשאבים של שלושת הקבצים האלה הם resourceKey1, resourceKey2 ו-resourceKey3, בהתאמה. הכותרת שנוצרת מהערכים האלה באמצעות קו נטוי ותווי פסיקים היא:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3