Method: files.copy

لإنشاء نسخة من الملف المحدّد

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
fileId

string

رقم تعريف الملف المراد نسخه.

معلمات طلب البحث

المَعلمات
convert

boolean

لتحديد ما إذا كان سيتم تحويل هذا الملف إلى التنسيق المقابل في "أدوات تحرير المستندات".

enforceSingleParent
(deprecated)

boolean

إيقاف نهائي: لم يعد نسخ الملفات إلى مجلدات متعددة متاحًا. استخدِم الاختصارات بدلاً من ذلك.

ocr

boolean

لتحديد ما إذا كنت تريد تجربة التعرّف البصري على الأحرف (OCR) على عمليات تحميل .jpg أو .png أو .gif أو .pdf.

ocrLanguage

string

إذا كانت القيمة ocr صحيحة، يتم إدخال تلميحات إلى اللغة التي سيتم استخدامها. القيم الصالحة هي رموز BCP 47.

pinned

boolean

لتحديد ما إذا كان سيتم تثبيت نسخة العنوان من النسخة الجديدة أم لا. يمكن أن يحتوي الملف على 200 نسخة مثبّتة كحد أقصى.

supportsAllDrives

boolean

ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.

timedTextLanguage

string

لغة النص المحدد زمنيًا.

timedTextTrackName

string

اسم مسار النص المحدد زمنيًا.

visibility

enum (Visibility)

مستوى رؤية الملف الجديد. هذه المَعلمة ملائمة فقط عندما لا يكون المصدر مستندًا أصليًا في "مستندات Google" وملف "conversion=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

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.