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