Method: files.create

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

این روش از یک URI /upload پشتیبانی می کند و رسانه های آپلود شده با ویژگی های زیر را می پذیرد:

  • حداکثر حجم فایل: 5120 گیگابایت
  • انواع MIME رسانه قابل قبول: */*

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

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

برنامه هایی که با متد create میانبر ایجاد می کنند باید نوع MIME application/vnd.google-apps.shortcut را مشخص کنند.

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

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

درخواست HTTP

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

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

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

پارامترها
enforceSingleParent
(deprecated)

boolean

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

ignoreDefaultVisibility

boolean

اینکه آیا تنظیمات پیش‌فرض نمایان بودن دامنه برای فایل ایجاد شده نادیده گرفته شود. مدیران دامنه می توانند انتخاب کنند که همه فایل های آپلود شده به صورت پیش فرض برای دامنه قابل مشاهده باشند. این پارامتر آن رفتار را برای درخواست دور می زند. مجوزها همچنان از پوشه های والد به ارث می رسند.

keepRevisionForever

boolean

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

ocrLanguage

string

یک اشاره زبان برای پردازش OCR در هنگام وارد کردن تصویر (کد ISO 639-1).

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

uploadType

string

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

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

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

boolean

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

includePermissionsForView

string

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

includeLabels

string

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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