Method: files.copy

یک کپی از فایل مشخص شده ایجاد می‌کند.

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایلی که قرار است کپی شود.

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

پارامترها
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

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

visibility

enum ( Visibility )

قابلیت مشاهده‌ی فایل جدید. مجوزها همچنان از پوشه‌های والد به ارث می‌رسند. این پارامتر فقط زمانی مرتبط است که منبع یک فایل Google Doc نباشد و زمانی که 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
  • https://www.googleapis.com/auth/drive.photos.readonly

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