Method: files.copy

تنشئ هذه الدالة نسخة من الملف المحدّد.

طلب HTTP

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

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

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

المعلمات
fileId

string

رقم تعريف الملف المطلوب نسخه

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

المعلمات
convert

boolean

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

enforceSingleParent
(deprecated)

boolean

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

ocr

boolean

يحدد هذا الخيار ما إذا كنت تريد محاولة استخدام ميزة التعرّف البصري على الأحرف في ملفات 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" ويكون التحويل=خطأ.

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

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