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