גישה לקובצי 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