پرش به محتویات

عملیات‌های فایل در گوگل درایو#

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

این نود می‌تواند به عنوان ابزاری هوشمند مورد استفاده قرار گیرد

این نود می‌تواند برای افزایش قابلیت‌های یک عامل هوشمند مورد استفاده قرار گیرد. هنگام استفاده به این صورت، بسیاری از پارامترها به طور خودکار تنظیم می‌شوند، یا با اطلاعاتی که توسط هوش مصنوعی هدایت می‌شود - برای اطلاعات بیشتر در مستندات پارامترهای ابزار هوشمند آشنا شوید.

کپی کردن فایل#

از این عملیات برای کپی کردن یک فایل در یک درایو استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Copy را انتخاب کنید.
  • فایل: فایلی را که می‌خواهید کپی کنید انتخاب کنید.
  • برای انتخاب عنوان از لیست کشویی، From list را برگزینید، برای وارد کردن URL فایل، By URL، یا برای وارد کردن fileId، By ID.
  • می‌توانید fileId را در URL قابل اشتراک‌گذاری فایل گوگل درایو بیابید: https://docs.google.com/document/d/fileId/edit#gid=0. در گوگل درایو خود، گزینه share > کپی لینک را بزنید تا URL قابل اشتراک‌گذاری فایل را دریافت کنید.
  • نام فایل: نامی که می‌خواهید برای نسخه کپی جدید فایل استفاده کنید.
  • کپی در همان پوشه: تعیین کنید که فایل در همان پوشه کپی شود یا نه. اگر غیرفعال باشد، موارد زیر را تنظیم کنید:
    • درایو والد: گزینه From list برای انتخاب درایو از لیست کشویی، By URL برای وارد کردن URL درایو، یا By ID برای وارد کردن driveId.
    • پوشه والد: گزینه From list برای انتخاب پوشه، By URL برای وارد کردن URL پوشه، یا By ID برای وارد کردن folderId.
    • می‌توانید driveId و folderId را با مراجعه به درایو مشترک یا پوشه در مرورگر خود و کپی کردن آخرین جزء URL پیدا کنید: https://drive.google.com/drive/u/1/folders/driveId.

گزینه‌ها#

  • کپی نیازمند مجوز نگارش: تعیین کنید که آیا خوانندگان و نظر دهندگان مجاز به کپی، چاپ یا دانلود فایل جدید هستند.
  • توضیحات: توضیح کوتاهی درباره فایل.

برای اطلاعات بیشتر، به مستندات API Method: files.copy | Google Drive مراجعه کنید.

ساخت فایل از متن#

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

در این پارامترها وارد شوید: - اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو. - منبع: File را انتخاب کنید. - عملیات: Create From Text را برگزینید. - محتوای فایل: محتوای فایل را وارد کنید تا برای ساخت فایل جدید استفاده شود. - نام فایل: نامی که می‌خواهید برای فایل جدید استفاده شود. - درایو والد: گزینه From list برای انتخاب درایو، By URL، یا By ID. - پوشه والد: گزینه From list، By URL، یا By ID.

می‌توانید driveId و folderId را با مراجعه به درایو مشترک یا پوشه در مرورگر و کپی کردن آخرین قسمت URL بیابید: https://drive.google.com/drive/u/1/folders/driveId.

گزینه‌ها#

  • خصوصیات برنامه (APP Properties): مجموعه‌ای از جفت کلید-مقدارهای دلخواه که مختص برنامه درخواست‌کننده هستند.
  • خصوصیات: مجموعه‌ای از جفت کلید-مقدارهای دلخواه که برای همه برنامه‌ها قابل مشاهده است.
  • نگهداشتن نسخه‌های دائم: تعیین کنید که آیا فیلد keepForever در نسخه اصلی جدید تنظیم شود. این فقط برای فایل‌هایی با محتواهای باینری قابل اعمال است. حداکثر ۲۰۰ نسخه می‌توانید نگهداری کنید، پس از آن باید نسخه‌های ثابت شده را حذف کنید.
  • زبان OCR: یک کد زبان ISO 639-1 برای کمک به OCR در تفسیر محتوا در زمان واردات.
  • استفاده از محتوا به عنوان متن قابل ایندکس: تعیین کنید آیا محتوای بارگذاری شده به عنوان متن ایندکس‌پذیر علامت‌گذاری شود.
  • تبدیل به سند گوگل: تعیین کنید که به جای فرمت پیش‌فرض .txt، یک سند گوگل ساخته شود. برای این کار باید API اسناد گوگل فعال شده باشد در کنسول API گوگل.

برای اطلاعات بیشتر، به مستندات API Method: files.insert | Google Drive مراجعه کنید.

حذف فایل#

از این عملیات برای حذف فایل از یک درایو استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Delete را برگزینید.
  • فایل: فایلی را که می‌خواهید حذف کنید انتخاب کنید.
  • برای انتخاب عنوان از لیست کشویی، From list، برای وارد کردن URL فایل، By URL، یا برای وارد کردن fileId، By ID.
  • می‌توانید fileId را در URL قابل اشتراک‌گذاری فایل گوگل درایو بیابید: https://docs.google.com/document/d/fileId/edit#gid=0. در گوگل درایو خود، گزینه share > کپی لینک را بزنید.

گزینه‌ها#

  • حذف دائمی: تعیین کنید که به جای انتقال به سطل زباله، فایل مستقیماً حذف شود یا خیر.

برای اطلاعات بیشتر، به مستندات API Method: files.delete | Google Drive مراجعه کنید.

دانلود فایل#

از این عملیات برای دانلود یک فایل از درایو استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Download را برگزینید.
  • فایل: فایلی که می‌خواهید دانلود کنید انتخاب کنید.
  • برای انتخاب عنوان از لیست کشویی، From list، برای وارد کردن URL فایل، By URL، یا برای وارد کردن fileId، By ID.
  • می‌توان fileId را در URL قابل اشتراک‌گذاری فایل گوگل درایو پیدا کرد: https://docs.google.com/document/d/fileId/edit#gid=0. در گوگل درایو خود، گزینه share > کپی لینک را بزنید.

گزینه‌ها#

  • قرار دادن فایل خروجی در فیلد: نام فیلد برای قرار دادن محتویات فایل باینری تا در اختیار نودهای بعدی قرار گیرد.
  • تبدیل فایل گوگل: فرمت‌هایی که هنگام دانلود فایل‌های گوگل می‌توان صادر کرد:
    • ** اسناد گوگل: فرمت صادر شده در زمان دانلود فایل‌های سند گوگل: HTML، MS Word Document، Open Office Document، PDF، Rich Text (rtf)، یا Text (txt)**.
    • تصاویر گوگل: فرمت صادر شده برای فایل‌های Drawing: JPEG، PDF، PNG، یا SVG.
    • اسلایدهای گوگل: فرمت‌های صادر شده هنگام دانلود فایل‌های Slides: MS PowerPoint، OpenOffice Presentation، یا PDF.
    • جداول گوگل: فرمت‌های صادر شده برای فایل‌های Sheets: CSV، MS Excel، Open Office Sheet، یا PDF.
  • نام فایل: نام برای فایل دانلود شده.

برای اطلاعات بیشتر، به مستندات API Method: files.get | Google Drive مراجعه کنید.

جابجایی فایل#

از این عملیات برای انتقال فایل به مکان دیگری در درایو استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Move را برگزینید.
  • فایل: فایلی را که می‌خواهید جابجا کنید انتخاب کنید.
  • برای انتخاب عنوان از لیست کشویی، From list، برای وارد کردن URL فایل، By URL، یا برای وارد کردن fileId, By ID.
  • می‌توانید fileId را در URL قابل اشتراک‌گذاری فایل گوگل درایو بیابید: https://drive.google.com/drive/u/1/folders/driveId. در گوگل درایو، گزینه share > کپی لینک را بزنید.
  • درایو والد: گزینه From list برای انتخاب درایو، By URL، یا By ID.
  • پوشه والد: گزینه From list، By URL، یا By ID.

می‌توانید driveId و folderId را با مراجعه به درایو/پوشه مشترک و کپی کردن قسمت آخر URL بیابید: https://drive.google.com/drive/u/1/folders/driveId.

برای اطلاعات بیشتر، مستندات API Method: parents.insert | Google Drive را ببینید.

اشتراک‌گذاری یک فایل#

از این عملیات برای افزودن مجوزهای اشتراک‌گذاری به یک فایل استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Share را برگزینید.
  • فایل: فایل مورد نظر برای اشتراک‌گذاری را انتخاب کنید.
  • برای انتخاب عنوان از لیست کشویی، From list، URL، یا By ID.
  • می‌توانید fileId را در URL قابل اشتراک‌گذاری فایل بیابید: https://docs.google.com/document/d/fileId/edit#gid=0. در گوگل درایو، گزینه share > کپی لینک را انتخاب کنید.
  • مجوزها: مجوزهای افزودن به فایل:
    • نقش: وظایف کاربرانی که مجاز به انجام آن هستند، را تعیین کنید. می‌تواند یکی از Commenter، File Organizer، Organizer، Owner، Reader، Writer باشد.
    • نوع: حوزه مجوز جدید را تعیین کنید:
      • کاربر (User): مجوز را به کاربر خاصی بدهید، با وارد کردن ایمیل آدرس وی.
      • گروه (Group): مجوز برای گروه خاصی، با وارد کردن ایمیل آدرس گروه.
      • دامنه (Domain): مجوز برای کل دامنه، با وارد کردن دامنه.
      • هر کسی (Anyone): مجوز به هر کسی بدهید. می‌توانید امکان کشف فایل را فعال کنید تا فایل از طریق جست‌وجو قابل کشف باشد.

گزینه‌ها#

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

برای اطلاعات بیشتر، مستندات API REST Resources: files | Google Drive را مشاهده کنید.

به‌روزرسانی یک فایل#

از این عملیات برای به‌روزرسانی یک فایل استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Update را برگزینید.
  • فایل برای به‌روزرسانی: فایل مورد نظر را انتخاب کنید.
  • برای انتخاب عنوان، From list، URL، یا By ID.
  • می‌توانید fileId را در URL قابل اشتراک‌گذاری فایل بیابید: https://docs.google.com/document/d/fileId/edit#gid=0. در گوگل درایو، گزینه share > کپی لینک.
  • تغییر محتوای فایل: تعیین کنید که آیا داده‌های باینری جدید ارسال شود تا محتوای فایل جایگزین شود. اگر فعال باشد، موارد زیر را پر کنید:
    • نام فیلد ورودی داده: نام فیلد ورودی که حاوی داده باینری است.
  • نام جدید فایل به‌روزرسانی‌شده: نام جدید فایل در صورت تمایل به تغییر نام فایل.

گزینه‌ها#

  • خصوصیات برنامه (APP Properties): مجموعه‌ای از جفت کلید-مقدار دلخواه که مخصوص برنامه درخواست‌کننده است.
  • خصوصیات: مجموعه‌ای از جفت کلید-مقدار دلخواه که برای همه برنامه‌ها قابل مشاهده است.
  • نگهداری نسخه‌ها برای همیش: تعیین کنید که آیا فیلد keepForever در نسخه اصلی جدید تنظیم شود. این فقط برای فایل‌هایی با محتواهای باینری است. حداکثر ۲۰۰ نسخه را می‌توان نگه داشت، پس باید نسخه‌های ثابت شده حذف شوند.
  • زبان OCR: یک کد زبان ISO 639-1 برای کمک به تفسیر محتوا در واردات.
  • استفاده از محتوا به عنوان متن قابل ایندکس: تعیین کنید آیا محتوای آپلود شده به عنوان متن ایندکس‌پذیر علامت‌گذاری شود.
  • انتقال فایل به سطل: آیا فایل بعد از به‌روزرسانی باید به سطل زباله منتقل شود یا نه. این فقط برای مالک فایل ممکن است.
  • بازگرداندن فیلدها: متادیتای مربوط به فایل را برگردانید. می‌تواند یکی یا چند مورد از موارد زیر باشد: [همه]، explicitlyTrashed، exportLinks، hasThumbnail، iconLink، ID، Kind، mimeType، Name، Permissions، Shared، Spaces، Starred، thumbnailLink، Trashed، Version، یا webViewLink.

برای اطلاعات بیشتر، به مستندات API Method: files.update | Google Drive مراجعه کنید.

آپلود فایل#

از این عملیات برای آپلود یک فایل استفاده کنید.

در این پارامترها وارد شوید:

  • اعتبارنامه‌ برای کانکشن: ایجاد یا انتخاب یک اعتبارنامه‌ گوگل درایو.
  • منبع: File را انتخاب کنید.
  • عملیات: Upload را برگزینید.
  • نام فیلد ورودی داده: نام فیلد ورودی حاوی داده باینری فایل.
  • نام فایل: نام فایل جدید.
  • درایو والد: گزینه From list برای انتخاب درایو، By URL، یا By ID.
  • پوشه والد: گزینه From list، By URL، یا By ID.

می‌توانید driveId و folderId را با مراجعه به درایو یا پوشه در مرورگر و کپی کردن قسمت آخر URL بیابید: https://drive.google.com/drive/u/1/folders/driveId.

گزینه‌ها#

  • خصوصیات برنامه (APP Properties): مجموعه‌ای از جفت کلید-مقدار دلخواه که مخصوص برنامه درخواست‌کننده است.
  • خصوصیات: مجموعه‌ای از جفت کلید-مقدار دلخواه که برای همه برنامه‌ها قابل مشاهده است.
  • نگهداری نسخه‌ها برای همیش: تعیین کنید که آیا فیلد keepForever در نسخه اصلی جدید تنظیم شود. این فقط برای فایل‌هایی با محتواهای باینری است. حداکثر ۲۰۰ نسخه را می‌توان نگه داشت، پس باید نسخه‌های ثابت شده حذف شوند.
  • زبان OCR: یک کد زبان ISO 639-1 برای کمک به تفسیر محتوا در واردات.
  • استفاده از محتوا به عنوان متن قابل ایندکس: تعیین کنید آیا محتوای آپلود شده به عنوان متن ایندکس‌پذیر علامت‌گذاری شود.
  • ساده‌سازی پاسخ: تعیین کنید آیا می‌خواهید نسخه ساده‌شده‌تری از پاسخ دریافت کنید یا تمامی فیلدها.
  • باز کردن فایل در خروجی: آیا می‌خواهید فایل بارگذاری شده را در خروجی برگردانید یا خیر.

برای اطلاعات بیشتر، به مستندات API Method: files.insert | Google Drive مراجعه کنید.