پشتیبانی از درایو مشترک را پیاده سازی کنید

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

برای شروع، هنگامی که برنامه شما عملیات زیر را انجام می دهد، باید پارامتر supportsAllDrives=true query را در درخواست های خود بگنجانید:

Drive API v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API v2

  • 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

پارامتر supportsAllDrives=true به Google Drive اطلاع می دهد که برنامه شما برای مدیریت فایل ها در درایوهای مشترک طراحی شده است.

برنامه‌هایی که مجوزها را می‌خوانند یا تغییر می‌دهند، تغییرات را ردیابی می‌کنند یا در چندین مجموعه جستجو می‌کنند، به قابلیت‌های درایو مشترک اضافی نیاز دارند. بقیه این سند تغییرات اضافی مورد نیاز برای انجام این وظایف را برجسته می کند.

جستجوی محتوا در درایو مشترک

برای یافتن فایل های کاربر در درایوهای مشترک از روش list در منبع files استفاده کنید. برای جستجوی درایو مشترک، به جستجوی درایوهای مشترک مراجعه کنید.

متد list شامل پارامترهای پرس و جو مخصوص درایو مشترک زیر است:

  • driveId : شناسه درایو مشترک برای جستجو.

  • corpora : مجموعه موارد (فایل ها یا اسناد) که پرس و جو در مورد آنها اعمال می شود. بدنه های پشتیبانی شده عبارتند از user , domain , drive و allDrives . برای کارایی user یا drive به allDrives ترجیح دهید. به طور پیش فرض، corpora روی user تنظیم شده است.

  • includeItemsFromAllDrives : آیا هر دو مورد My Drive و درایو مشترک باید در نتایج گنجانده شوند. اگر موجود نباشد یا روی false تنظیم شود، موارد درایو مشترک برگردانده نمی‌شوند.

  • supportsAllDrives : اینکه آیا برنامه درخواست کننده هم My Drive و هم درایو مشترک را پشتیبانی می کند. اگر نادرست باشد، موارد درایو مشترک در پاسخ گنجانده نشده است.

حالت‌های پرس و جو زیر مختص درایوهای مشترک هستند:

includeItemsFromAllDrives corpora شرح استعلام
true user فایل‌هایی را که کاربر به آنها دسترسی داشته است، از جمله فایل‌های درایو مشترک و My Drive را جست‌وجو می‌کند.
true domain فایل‌هایی را که در دامنه به اشتراک گذاشته شده‌اند، از جمله فایل‌های درایو مشترک و My Drive را جستجو می‌کند.
true drive تمام موارد موجود در درایو مشترک مشخص شده را پرس و جو می کند. driveId باید در درخواست مشخص شود.
true allDrives فایل‌هایی را که کاربر به آن‌ها دسترسی داشته است و همه درایوهای مشترکی که در آن عضو هستند را جستجو می‌کند. توجه داشته باشید که پاسخ ممکن است شامل incompleteSearch:true ، که نشان می دهد برخی از مجموعه ها برای این درخواست جستجو نشده اند.

ردیابی تغییرات در درایو مشترک

از روش list در منبع changes برای ردیابی تغییرات در درایو مشترک استفاده کنید. برای اطلاعات بیشتر، ردیابی تغییرات برای کاربران و درایوهای مشترک را ببینید.

متد list شامل پارامترهای پرس و جو مخصوص درایو مشترک زیر است:

  • driveId : درایو مشترکی که تغییرات از آن برگردانده می شود. اگر مشخص شده باشد، شناسه‌های تغییر به تغییرات موارد در درایو مشترک اشاره دارد که وضعیت فعلی یک فایل را ارائه می‌کند. برای اشاره به تغییر درایو مشترک خاص، هر دو شناسه درایو مشترک و شناسه تغییر باید به عنوان یک شناسه استفاده شوند.

  • includeItemsFromAllDrives : آیا فایل های درایو مشترک یا تغییرات باید در لیست تغییرات گنجانده شود.

  • supportsAllDrives : اینکه آیا برنامه درخواست کننده از درایوهای مشترک پشتیبانی می کند. اگر نادرست باشد، موارد درایو مشترک، از جمله درایوهای مشترک و فایل‌های موجود در درایو مشترک، برگردانده نمی‌شوند.

حالت‌های پرس و جو زیر مختص درایوهای مشترک هستند:

includeItemsFromAllDrives driveId شرح استعلام
true خیر تغییرات منعکس کننده تغییرات فایل های داخل یا خارج از درایوهای مشترک است که کاربر به آنها دسترسی داشته است، و همچنین تغییرات در درایوهای مشترک که کاربر در آن عضو است.
true بله تغییرات منعکس کننده تغییرات درایو مشترک خاصی است که مشخص شده و موارد داخل آن درایو مشترک.

برای جزئیات بیشتر درباره رفتار گزارش تغییرات، به پیگیری تغییرات برای کاربران و درایوهای مشترک مراجعه کنید.

پشتیبانی از درایو مشترک را در رابط کاربری Drive فعال کنید

برای دسترسی به محتوای درایو مشترک با استفاده از رابط کاربری Drive، مطمئن شوید که کادر پشتیبانی از درایوهای مشترک را در برگه ادغام رابط کاربری Drive در API Google Drive در کنسول Google Cloud علامت زده‌اید. برای اطلاعات بیشتر، به پیکربندی یکپارچگی رابط کاربری Drive مراجعه کنید.

از Google Picker با درایوهای مشترک استفاده کنید

Google Picker از انتخاب موارد در درایوهای مشترک پشتیبانی می کند. برای جزئیات در مورد فعال کردن پشتیبانی درایو مشترک و افزودن نماهای درایوهای مشترک در انتخابگر، به Google Picker API مراجعه کنید.