Method: files.update

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

هنگام فراخوانی این متد، فقط فیلدهایی را در درخواستی که می‌خواهید تغییر دهید، پر کنید. هنگام به‌روزرسانی فیلدها، ممکن است برخی از فیلدها مانند modifiedDate به طور خودکار تغییر کنند. این متد از patch semantics پشتیبانی می‌کند.

این متد از آدرس /upload پشتیبانی می‌کند و رسانه‌های آپلود شده با مشخصات زیر را می‌پذیرد:

  • حداکثر حجم فایل: ۵۱۲۰ گیگابایت
  • انواع MIME رسانه پذیرفته شده: */*

    (به جای مقدار */* ، یک نوع MIME معتبر مشخص کنید. */* فقط برای نشان دادن این است که هر نوع MIME معتبری می‌تواند آپلود شود. برای اطلاعات بیشتر، به انواع MIME پشتیبانی شده توسط Google Workspace و Google Drive مراجعه کنید.)

برای اطلاعات بیشتر در مورد آپلود فایل‌ها، به بخش آپلود داده‌های فایل مراجعه کنید.

درخواست HTTP

  • آپلود URI، برای درخواست‌های آپلود رسانه:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • آدرس URL فراداده، برای درخواست‌های فقط فراداده:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
fileId

string

شناسه فایلی که باید به‌روزرسانی شود.

پارامترهای پرس و جو

پارامترها
addParents

string

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

convert
(deprecated)

boolean

منسوخ شده: این پارامتر هیچ عملکردی ندارد.

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum ( ModifiedDateBehavior )

رفتاری را که modifiedDate در آن به‌روزرسانی می‌شود، تعیین می‌کند. این، setModifiedDate را لغو می‌کند.

newRevision

boolean

اینکه آیا یک آپلود blob باید یک نسخه جدید ایجاد کند یا خیر. اگر false باشد، داده‌های blob در نسخه head فعلی جایگزین می‌شوند. اگر true باشد یا نباشد، یک blob جدید به عنوان نسخه head ایجاد می‌شود و نسخه‌های پین نشده قبلی برای مدت کوتاهی حفظ می‌شوند. نسخه‌های پین شده به طور نامحدود، با استفاده از سهمیه ذخیره‌سازی اضافی، تا حداکثر ۲۰۰ نسخه، ذخیره می‌شوند. برای جزئیات بیشتر در مورد نحوه حفظ نسخه‌ها، به مرکز راهنمای Drive مراجعه کنید.

ocr

boolean

آیا OCR را روی فایل‌های آپلود شده با فرمت‌های .jpg، .png، .gif یا .pdf امتحان کنید یا خیر.

ocrLanguage

string

اگر ocr درست باشد، به زبانی که باید استفاده شود اشاره می‌کند. مقادیر معتبر، کدهای BCP 47 هستند.

pinned

boolean

آیا نسخه جدید پین شود یا خیر. یک فایل می‌تواند حداکثر ۲۰۰ نسخه پین‌شده داشته باشد.

removeParents

string

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

setModifiedDate

boolean

آیا تاریخ تغییر با استفاده از مقداری که در بدنه درخواست ارائه شده است، تنظیم شود یا خیر. تنظیم این فیلد به true معادل modifiedDateBehavior=fromBodyOrNow و false معادل modifiedDateBehavior=now است. برای جلوگیری از هرگونه تغییر در تاریخ تغییر، modifiedDateBehavior=noChange تنظیم کنید.

supportsAllDrives

boolean

اینکه آیا برنامه درخواست‌کننده از هر دو درایوهای من و درایوهای اشتراکی پشتیبانی می‌کند یا خیر.

supportsTeamDrives
(deprecated)

boolean

منسوخ شده: به جای آن supportsAllDrives استفاده کنید.

timedTextLanguage

string

زبان متن زمان‌بندی‌شده.

timedTextTrackName

string

نام آهنگ متنی زمان‌بندی‌شده.

updateViewedDate

boolean

آیا پس از به‌روزرسانی موفقیت‌آمیز فایل، تاریخ نمایش به‌روزرسانی شود یا خیر.

uploadType

string

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

مقادیر قابل قبول عبارتند از:

  • media - آپلود ساده . فقط رسانه را آپلود کنید، بدون هیچ گونه فراداده‌ای.
  • multipart - آپلود چندبخشی . هم رسانه و هم فراداده‌های آن را در یک درخواست آپلود کنید.
  • resumable - آپلود قابل از سرگیری . فایل را به روشی قابل از سرگیری، با استفاده از یک سری حداقل دو درخواست که اولین درخواست شامل ابرداده است، آپلود کنید.
useContentAsIndexableText

boolean

اینکه آیا از محتوا به عنوان متن قابل فهرست‌بندی استفاده شود یا خیر.

includePermissionsForView

string

مشخص می‌کند که کدام مجوزهای نمای اضافی باید در پاسخ لحاظ شوند. فقط published پشتیبانی می‌شود.

includeLabels

string

فهرستی از شناسه‌های برچسب‌ها که با کاما از هم جدا شده‌اند و باید در بخش labelInfo پاسخ قرار گیرند.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از File است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از File است.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

برخی از حوزه‌ها محدود شده‌اند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.