גישה לקובצי 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 יכולות לציין מפתח משאב אחד או יותר עם הכותרת X-Goog-Drive-Resource-Keys של ה-HTTP.

תחביר

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

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

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