Method: files.patch

فراداده و/یا محتوای یک فایل را به روز می کند. هنگام فراخوانی این روش، فقط فیلدهایی را در درخواستی که می خواهید تغییر دهید پر کنید. هنگام به روز رسانی فیلدها، ممکن است برخی از فیلدها به طور خودکار تغییر کنند، مانند modifiedDate. این روش از معنای پچ پشتیبانی می کند.

درخواست HTTP

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
fileId

string

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

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

مولفه های
addParents

string

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

convert
(deprecated)

boolean

Deprecated: این پارامتر عملکردی ندارد.

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum ( ModifiedDateBehavior )

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

newRevision

boolean

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

ocr

boolean

آیا باید OCR در آپلودهای .jpg، .png، .gif یا .pdf.

ocrLanguage

string

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

pinned

boolean

آیا برای پین کردن نسخه جدید. یک فایل می تواند حداکثر 200 ویرایش پین شده داشته باشد. توجه داشته باشید که در صورت عدم وجود باری در درخواست، این قسمت نادیده گرفته می شود.

removeParents

string

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

setModifiedDate

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

زبان متن زمان دار.

timedTextTrackName

string

نام آهنگ متن زمان‌دار.

updateViewedDate

boolean

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

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

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