اگر از نسخه ۲ رابط برنامهنویسی گوگل درایو استفاده میکنید، بیشتر محتوای راهنمای رابط برنامهنویسی گوگل درایو نسخه ۳ مربوط به نسخه ۲ نیز میشود. این بخش شامل تمام اطلاعات مختص نسخه ۲ است و با آنچه در صفحات خاص راهنمای نسخه ۳ نشان داده شده است، متفاوت است. برای دریافت متن کامل، هر زیربخش شامل پیوند به صفحه راهنمای مربوطه است.
برای فهرست کاملی از تفاوتها، به مرجع مقایسه Drive API نسخه ۲ و نسخه ۳ مراجعه کنید.
دانلود و انتشار نسخههای اصلاحشده فایل
در صفحه دانلود و انتشار نسخههای اصلاحشده فایل ، اطلاعات زیر مختص نسخه ۲ است و جایگزین بخشهای نشان داده شده برای نسخه ۳ میشود:
فهرست کردن و دانلود نسخههای جداگانه
وقتی فهرستی از ویرایشهای یک فایل را دریافت کردید، میتوانید محتوای هر ویرایش را با ارسال یک درخواست GET مجاز به ویژگی [] downloadUrl ](/workspace/drive/api/reference/rest/v2/revisions) آن دانلود کنید. گوگل درایو این URL کوتاهمدت را هنگام درخواست ویرایش ایجاد میکند. برای استفادههای بعدی به آن تکیه نکنید.
همچنین میتوانید با بررسی ویژگی exportLinks نسخه را در یکی از قالبهای پشتیبانیشده صادر کنید.
ویژگیهای فایل سفارشی
علاوه بر اطلاعات موجود در صفحه افزودن ویژگیهای فایل سفارشی ، اطلاعات زیر مختص نسخه ۲ است:
دسترسی به ویژگیها با استفاده از منبع properties انجام میشود.
این ساختار یک ویژگی معمولی است که ممکن است برای ذخیره شناسه پایگاه داده یک فایل Drive روی فایل استفاده شود.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
برای اطلاعات بیشتر در مورد محدودیتها، به properties در مستندات مرجع مراجعه کنید.
فعال کردن پشتیبانی از درایو اشتراکی
علاوه بر اطلاعات موجود در صفحه پشتیبانی از پیادهسازی درایو اشتراکی ، این فیلد اضافی trashedDate برای نسخه ۲ جایگزین کنید.
در پیادهسازی پشتیبانی از درایو مشترک ، متدهای زیر هنگام کار با محتوای درایوهای مشترک، supportsAllDrives=true نیاز دارند:
-
files.get -
files.list -
files.insert -
files.update -
files.patch -
files.copy -
files.trash -
files.untrash -
files.delete -
files.touch -
children.insert -
parents.insert -
changes.list -
changes.getStartPageToken -
changes.get -
permissions.list -
permissions.get -
permissions.insert -
permissions.update -
permissions.patch -
permissions.delete
متدهای changes.get و changes.list چندین پارامتر مخصوص درایوهای اشتراکی دارند. برای مشاهده لیست پارامترها، به بخش پیگیری تغییرات در درایو اشتراکی مراجعه کنید.
آپلود فایلها
در صفحه بارگذاری دادههای فایل ، توجه داشته باشید که این اطلاعات مختص نسخه ۲ است:
انواع داده را به Google Docs وارد کنید
وقتی فایلی را در گوگل درایو ایجاد میکنید، میتوانید برخی از انواع فایل را به یک سند گوگل داکس، گوگل شیت یا گوگل اسلاید تبدیل کنید. پارامترهای کوئری convert فایل files.insert را وارد کنید و ویژگی mimeType (نام فضای کاری) فایل را تنظیم کنید. برای اطلاعات بیشتر، به آپلود دادههای فایل مراجعه کنید.
اشتراکگذاری فایلها، پوشهها و درایوها
توجه داشته باشید که در صفحه اشتراکگذاری فایلها، پوشهها و درایوها ، در نسخه ۳ فقط یک فیلد، role ، نقشهای مؤثر برای کاربر، گروه یا دامنه را مشخص میکند. در نسخه ۲، به هر دو فیلد role و additionalRoles مربوط به یک مجوز نیاز دارید که نقشهای مؤثر کاربر، گروه یا دامنه را برای یک مورد مشخص نشان دهند.
تفاوتهای جستجوی عبارت برای نسخه ۲
فیلد title نسخه ۲، در نسخه ۳، name است. برای مثال، به جستجوی فایلها و پوشهها مراجعه کنید.
فیلد createdDate نسخه ۲، در نسخه ۳، createdTime است. برای مثال، به جستجوی درایوهای مشترک مراجعه کنید.
فیلد modifiedDate نسخه ۲ در نسخه ۳، modifiedTime است. فیلد lastViewedByMeDate نسخه ۲ در نسخه ۳، viewedByMeTime است. برای جزئیات بیشتر، به عبارات و عملگرهای جستجوی پرسوجو مراجعه کنید.