با استفاده از کلیدهای منبع به فایل‌های Drive مشترک دسترسی پیدا کنید

می‌توانید فایل‌ها و پوشه‌های Google Drive را با استفاده از رابط کاربری Drive یا از طریق Google Drive API با دیگران به اشتراک بگذارید. وقتی از Drive اشتراک‌گذاری می‌کنید، می‌توانید کنترل کنید که آیا افراد می‌توانند فایل را ویرایش، نظر بدهند یا فقط باز کنند.

یک کلید منبع به محافظت از فایل شما در برابر دسترسی ناخواسته کمک می کند. کلیدهای منبع یک پارامتر اضافی هستند که ارسال می شوند تا کاربران بتوانند به فایل های خاصی که با استفاده از یک پیوند به اشتراک گذاشته شده اند دسترسی داشته باشند. کاربرانی که قبلا فایل را مشاهده نکرده اند باید کلید منبع را برای دسترسی به آن ارائه دهند. کسانی که اخیراً فایل را مشاهده کرده اند یا دسترسی مستقیم دارند، برای دسترسی به فایل به کلید منبع نیاز ندارند.

یک فایل Drive که با یک پیوند به اشتراک گذاشته شده است را فقط کاربرانی می‌توانند کشف کنند که می‌توانند در نتیجه منبع permissions type=user یا type=group به فایل دسترسی داشته باشند. درخواست‌های کاربرانی که فقط با استفاده از مجوز type=domain یا type=anyone به این فایل‌های به اشتراک گذاشته شده پیوند دسترسی دارند، ممکن است به یک کلید منبع نیاز داشته باشند.

برای اطلاعات بیشتر درباره مجوزها، به اشتراک گذاری فایل ها، پوشه ها و درایوها مراجعه کنید. برای فهرست کامل نقش‌ها و عملیات‌های مجاز هر کدام، به نقش‌ها و مجوزها مراجعه کنید.

کلید منبع را از فایل بخوانید

Drive API کلید منبع فایل را در قسمت فقط خواندنی resourceKey منبع files برمی گرداند.

اگر فایل یک میانبر Drive باشد، کلید منبع برای هدف میانبر در قسمت shortcutDetails.targetResourceKey فقط خواندنی برگردانده می شود.

فیلدهای موجود در منبع files که نشانی‌های اینترنتی را برمی‌گردانند، مانند exportLinks ، webContentLink ، و webViewLink ، همچنین شامل resourceKey می‌شوند. کلاینت هایی که با Drive UI ادغام می شوند نیز می توانند از 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