اگر از Google Drive API نسخه 2 استفاده می کنید، بیشتر محتوای Google Drive API Guide v3 به نسخه 2 نیز مربوط می شود. این بخش شامل تمام اطلاعاتی است که مختص نسخه 2 است و با آنچه در صفحات خاص راهنمای نسخه 3 نشان داده شده است متفاوت است. برای دریافت متن کامل، هر زیربخش حاوی پیوند به صفحه راهنمای مربوطه است.
برای فهرست کامل تفاوت‌ها، به مرجع مقایسه Drive API v2 و v3 مراجعه کنید.
نسخه های فایل را دانلود و منتشر کنید
در صفحه بازبینی فایل دانلود و انتشار ، اطلاعات زیر مختص v2 است و جایگزین این بخش‌های نشان‌داده‌شده برای v3 می‌شود:
فهرست و دانلود نسخه های جداگانه
هنگامی که فهرستی از ویرایش‌های یک فایل دریافت کردید، می‌توانید محتوای هر ویرایش را با ارسال یک درخواست GET مجاز به ویژگی [] downloadUrl ](/drive/api/reference/rest/v2/revisions) آن دانلود کنید. هنگامی که شما درخواست تجدید نظر می کنید، Google Drive این URL کوتاه مدت را ایجاد می کند. برای استفاده بعدی به آن اعتماد نکنید.
همچنین می‌توانید با بررسی ویژگی exportLinks ویرایش را در یکی از قالب‌های پشتیبانی شده صادر کنید.
ویژگی های فایل سفارشی
علاوه بر اطلاعات موجود در صفحه افزودن ویژگی های فایل سفارشی ، اطلاعات زیر مختص v2 است:
ویژگی ها با استفاده از منبع properties قابل دسترسی هستند.
این ساختار یک ویژگی معمولی است که ممکن است برای ذخیره شناسه پایگاه داده فایل Drive در فایل استفاده شود.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
برای کسب اطلاعات بیشتر در مورد محدودیت ها، properties در مستندات مرجع ببینید.
پشتیبانی از درایو مشترک را فعال کنید
علاوه بر اطلاعات موجود در صفحه پشتیبانی Implement shared drive ، این فیلد اضافی trashedDate برای نسخه 2 جایگزین کنید.
در پیاده‌سازی پشتیبانی از درایو مشترک ، روش‌های زیر به 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 دارای چندین پارامتر خاص برای درایوهای مشترک هستند. برای فهرستی از پارامترها، به ردیابی تغییرات در بخش درایو مشترک مراجعه کنید.
فایل ها را آپلود کنید
در صفحه داده های فایل آپلود ، توجه کنید که این اطلاعات مختص نسخه 2 است:
وارد کردن به انواع Google Docs
وقتی فایلی را در Google Drive ایجاد می‌کنید، می‌توانید برخی از انواع فایل‌ها را به سند Google Docs، Google Sheets یا Google Slides تبدیل کنید. پارامترهای پرس و جوی convert files.insert را وارد کنید و ویژگی (نام فضای کار) mimeType فایل را تنظیم کنید. برای اطلاعات بیشتر، آپلود داده‌های فایل را ببینید.
فایل ها، پوشه ها و درایوها را به اشتراک بگذارید
اطلاعیه در صفحه اشتراک گذاری فایل ها، پوشه ها و درایوها ، در نسخه 3 فقط یک فیلد، role ، نقش های موثر برای کاربر، گروه یا دامنه را مشخص می کند. در نسخه 2، شما به هر دو قسمت role و additionalRoles یک مجوز نیاز دارید که نقش های مؤثری را که کاربر، گروه یا دامنه برای یک مورد خاص دارند، نشان دهد.
تفاوت جستجو برای v2
قسمت title v2 name در v3 است. برای مثال، به جستجوی فایل‌ها و پوشه‌ها مراجعه کنید.
فیلد v2 createdDate در v3 createdTime است. برای مثال، به جستجوی درایوهای مشترک مراجعه کنید.
قسمت v2 modifiedDate در v3 modifiedTime است. فیلد v2 lastViewedByMeDate در نسخه 3 viewedByMeTime می شود. برای جزئیات بیشتر، اصطلاحات و عملگرهای درخواست جستجو را ببینید.