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

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

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

רק משתמשים שיכולים לגשת לקובץ כתוצאה ממשאב type=user או type=group permissions יכולים לגלות קובץ Drive שמשותף באמצעות קישור. ייתכן שיהיה צורך במפתח משאב כדי לבקש ממשתמשים שיש להם גישה רק לקבצים ששותפו באמצעות קישור בהרשאה 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