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

درایوهای مشترک از مدل‌های مختلف سازماندهی، اشتراک‌گذاری و مالکیت 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 اطلاع می دهد که برنامه شما برای مدیریت فایل ها در درایوهای مشترک طراحی شده است.

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

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

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

متد files.list شامل فیلدهای خاص درایو مشترک و حالت‌های پرس و جو است:

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

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

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

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

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

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

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

از روش changes.list برای ردیابی تغییرات در درایو مشترک استفاده کنید. این بخش فیلدهای مشترک درایو خاص را در متد changes.list پوشش می دهد. برای اطلاعات بیشتر، به ردیابی تغییرات برای کاربران و درایوهای مشترک مراجعه کنید. متد changes.list شامل فیلدهای مشترک درایو و حالت‌های پرس و جو است:

  • driveId - درایو مشترکی که تغییرات از آن بازگردانده می شود. اگر مشخص شده باشد، شناسه‌های تغییر به تغییرات در درایو مشترک اشاره می‌کنند، نه تغییرات در فایل‌های نشان داده شده به کاربر. برای اشاره به تغییر درایو مشترک خاص، هر دو شناسه درایو مشترک و شناسه تغییر باید به عنوان یک شناسه استفاده شوند.
  • supportsAllDrives — اینکه آیا برنامه درخواست کننده از درایوهای مشترک پشتیبانی می کند. اگر نادرست باشد، موارد درایو مشترک، از جمله درایوهای مشترک و فایل‌های موجود در درایو مشترک، برگردانده نمی‌شوند.
  • includeItemsFromAllDrives - آیا فایل های درایو مشترک یا تغییرات باید در لیست تغییرات گنجانده شود.

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

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

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

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

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

استفاده از انتخابگر فایل با درایوهای مشترک

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

مراحل بعدی

برای دریافت راهنمایی در مورد ایجاد درایوهای مشترک و مدیریت مجوزهای درایو مشترک، به مدیریت درایوهای مشترک ادامه دهید.