فراداده و/یا محتوای یک فایل را به روز می کند. هنگام فراخوانی این روش، فقط فیلدهایی را در درخواستی که می خواهید تغییر دهید پر کنید. هنگام بهروزرسانی فیلدها، ممکن است برخی از فیلدها به طور خودکار تغییر کنند، مانند modifiedDate . این روش از معنای پچ پشتیبانی می کند.
این روش از یک URI /upload پشتیبانی می کند و رسانه های آپلود شده با ویژگی های زیر را می پذیرد:
حداکثر حجم فایل: 5120 گیگابایت
انواع MIME رسانه قابل قبول:*/*
توجه: یک نوع MIME معتبر به جای مقدار واقعی */* تعیین کنید. */* تحت اللفظی فقط برای نشان دادن اینکه هر نوع MIME معتبری را می توان آپلود کرد استفاده می شود.
برای اطلاعات بیشتر در مورد آپلود فایل ها، به آپلود داده های فایل مراجعه کنید.
درخواست HTTP
URI آپلود، برای درخواست های آپلود رسانه: PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
URI فراداده، برای درخواستهای فقط فراداده: PATCH https://www.googleapis.com/drive/v3/files/{fileId}
نوع درخواست آپلود به /upload URI. اگر دادهها را با URI /upload آپلود میکنید، این فیلد ضروری است. اگر در حال ایجاد یک فایل فقط متادیتا هستید، این فیلد مورد نیاز نیست. علاوه بر این، این فیلد در ویجت "این روش را امتحان کنید" نشان داده نمی شود زیرا ویجت از آپلود داده ها پشتیبانی نمی کند.
مقادیر قابل قبول عبارتند از:
media - آپلود ساده فقط رسانه را بارگذاری کنید، بدون هیچ گونه ابرداده.
multipart - آپلود چند قسمتی . هم رسانه و هم فراداده آن را در یک درخواست آپلود کنید.
resumable - Resumable upload . با استفاده از یک سری حداقل دو درخواست که در آن درخواست اول شامل ابرداده است، فایل را به روشی قابل ازسرگیری آپلود کنید.
fileId
string
شناسه فایل
پارامترهای پرس و جو
مولفه های
uploadType
string
نوع درخواست آپلود به /upload URI. اگر دادهها را با URI /upload آپلود میکنید، این فیلد ضروری است. اگر در حال ایجاد یک فایل فقط متادیتا هستید، این فیلد مورد نیاز نیست. علاوه بر این، این فیلد در ویجت "این روش را امتحان کنید" نشان داده نمی شود زیرا ویجت از آپلود داده ها پشتیبانی نمی کند.
مقادیر قابل قبول عبارتند از:
media - آپلود ساده فقط رسانه را بارگذاری کنید، بدون هیچ گونه ابرداده.
multipart - آپلود چند قسمتی . هم رسانه و هم فراداده آن را در یک درخواست آپلود کنید.
resumable - Resumable upload . با استفاده از یک سری حداقل دو درخواست که در آن درخواست اول شامل ابرداده است، فایل را به روشی قابل ازسرگیری آپلود کنید.
addParents
string
فهرستی از شناسههای والد جدا شده با کاما برای افزودن.
enforceSingleParent (deprecated)
boolean
منسوخ شده: افزودن فایل به چند پوشه دیگر پشتیبانی نمی شود. به جای آن از میانبرها استفاده کنید.
keepRevisionForever
boolean
فیلد "keepForever" در ویرایش سر جدید تنظیم شود یا خیر. این فقط برای فایلهایی با محتوای باینری در Google Drive قابل اجرا است. فقط 200 ویرایش برای فایل را می توان برای همیشه نگه داشت. اگر به حد مجاز رسیده اید، سعی کنید ویرایش های پین شده را حذف کنید.
ocrLanguage
string
یک اشاره زبان برای پردازش OCR در هنگام وارد کردن تصویر (کد ISO 639-1).
removeParents
string
فهرستی از شناسههای والد جدا شده با کاما برای حذف.
supportsAllDrives
boolean
اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند.
supportsTeamDrives (deprecated)
boolean
منسوخ شده: به جای آن از supportsAllDrives استفاده کنید.
useContentAsIndexableText
boolean
آیا از محتوای آپلود شده به عنوان متن قابل نمایه سازی استفاده شود یا خیر.
includePermissionsForView
string
مشخص می کند که کدام مجوزهای اضافی در پاسخ گنجانده شود. فقط "منتشر شده" پشتیبانی می شود.
includeLabels
string
فهرستی از شناسههای برچسبهایی که با کاما از هم جدا شدهاند تا در قسمت labelInfo پاسخ قرار داده شوند.