Method: files.insert

یک فایل جدید درج می‌کند.

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

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

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

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

برنامه‌هایی که با استفاده از files.insert میانبر ایجاد می‌کنند، باید نوع MIME مربوط به application/vnd.google-apps.shortcut را مشخص کنند.

برنامه‌ها باید هنگام درج فایل‌ها با استفاده از API، پسوند فایل را در ویژگی title مشخص کنند. برای مثال، عملیاتی برای درج یک فایل JPEG باید چیزی شبیه به "title": "cat.jpg" را در متادیتا مشخص کند.

درخواست‌های GET بعدی شامل ویژگی فقط خواندنی fileExtension می‌شوند که با پسوندی که در ابتدا در ویژگی title مشخص شده است، پر می‌شود. هنگامی که یک کاربر Google Drive درخواست دانلود یک فایل را می‌دهد، یا هنگامی که فایل از طریق کلاینت همگام‌سازی دانلود می‌شود، Drive یک نام فایل کامل (با پسوند) بر اساس عنوان ایجاد می‌کند. در مواردی که پسوند وجود ندارد، Drive تلاش می‌کند تا پسوند را بر اساس نوع MIME فایل تعیین کند.

درخواست HTTP

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

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

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

پارامترها
convert

boolean

آیا این فایل به فرمت مربوطه‌ی ویرایشگرهای اسناد تبدیل شود یا خیر.

enforceSingleParent
(deprecated)

boolean

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

ocr

boolean

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

ocrLanguage

string

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

pinned

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

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

timedTextTrackName

string

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

uploadType

string

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

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

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

boolean

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

visibility

enum ( Visibility )

قابلیت مشاهده فایل جدید. مجوزها همچنان از پوشه‌های والد به ارث می‌رسند. این پارامتر فقط زمانی مرتبط است که convert=false .

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

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