راهنمای Drive API v2

اگر از Google Drive API نسخه ۲ استفاده می‌کنید، بیشتر محتوای راهنمای Google Drive API نسخه ۳ به نسخه ۲ نیز مربوط می‌شود. این بخش حاوی همه اطلاعاتی است که مختص نسخه ۲ است و با آنچه در صفحه‌های خاص راهنمای نسخه ۳ نشان داده می‌شود متفاوت است. برای دریافت بافت کامل، هر زیربخش حاوی پیوند به صفحه راهنمای مربوطه است.

برای مشاهده فهرست کامل تفاوت‌ها، به مرجع مقایسه Drive API نسخه ۲ و ۳ مراجعه کنید.

بارگیری و انتشار بازبینی‌های فایل

در صفحه بارگیری و انتشار بازبینی‌های فایل، اطلاعات زیر مختص نسخه ۲ است و جایگزین این بخش‌ها می‌شود که برای نسخه ۳ نشان داده شده است:

فهرست کردن و بارگیری نسخه‌های بازبینی به‌صورت جداگانه

پس‌از دریافت فهرست بازبینی‌های فایل، می‌توانید محتوای هر بازبینی را با ارسال درخواست GET مجاز به ویژگی []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) آن بارگیری کنید. وقتی درخواست بازبینی می‌کنید، Google Drive این نشانی وب کوتاه‌مدت را تولید می‌کند. برای استفاده بعدی به آن تکیه نکنید.

همچنین می‌توانید با بررسی ویژگی 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»

وقتی فایلی در Google Drive ایجاد می‌کنید، می‌توانید برخی‌از انواع فایل را به سند «سندنگار Google»، «کاربرگ‌نگار Google»، یا «اسلایدنگار Google» تبدیل کنید. پارامترهای پُرسمان files.insert convert را اضافه کنید و ویژگی (workspace_name) mimeType فایل را تنظیم کنید. برای اطلاعات بیشتر، بارگذاری داده‌های فایل را ببینید.

هم‌رسانی فایل‌ها، پوشه‌ها، و درایوها

توجه داشته باشید که در صفحه هم‌رسانی فایل‌ها، پوشه‌ها، و درایوها، در نسخه ۳ فقط یک فیلد، role، نقش‌های مؤثر را برای کاربر، گروه، یا دامنه مشخص می‌کند. در نسخه ۲، به هر دو فیلد role و additionalRoles نیاز دارید تا اجازه نقش‌های مؤثری را که کاربر، گروه، یا دامنه برای موردی خاص دارد منعکس کند.

تفاوت‌های پرسمان جستجو برای نسخه ۲

فیلد title در نسخه ۲ در نسخه ۳ name است. برای مثال، جستجوی فایل‌ها و پوشه‌ها را ببینید.

فیلد createdDate در نسخه ۲ در نسخه ۳ createdTime است. برای مثال، به جستجوی درایوهای مشترک مراجعه کنید.

فیلد modifiedDate در نسخه ۲ در نسخه ۳ modifiedTime است. فیلد lastViewedByMeDate نسخه ۲ در نسخه ۳ viewedByMeTime است. برای جزئیات بیشتر، عبارت‌های پرسمان جستجو و عملگرها را ببینید.