Method: files.copy

ينشئ نسخة من الملف ويطبّق أي تحديثات مطلوبة باستخدام دلالات رموز التصحيح.

طلب HTTP

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

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

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

المَعلمات
fileId

string

رقم تعريف الملف.

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

المَعلمات
enforceSingleParent

boolean

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

ignoreDefaultVisibility

boolean

يمكنك اختيار ما إذا كان سيتم تجاهل إعدادات مستوى الظهور التلقائية للنطاق في الملف الذي تم إنشاؤه. يمكن لمشرفي النطاق اختيار جعل جميع الملفات التي يتم تحميلها مرئية للنطاق بشكل تلقائي، وهذه المَعلمة تتجاوز هذا السلوك بالنسبة إلى الطلب. تظل الأذونات موروثة من المجلدات الرئيسية.

keepRevisionForever

boolean

تحديد ما إذا كان سيتم ضبط الحقل 'keepForever' في نسخة الرأس الجديدة. لا ينطبق هذا إلا على الملفات التي تتضمن محتوى ثنائيًا في Google Drive. يمكن الاحتفاظ بـ 200 نسخة سابقة فقط للملف للأبد. عند الوصول إلى هذا الحد، يمكنك محاولة حذف النُسخ السابقة المثبَّتة.

ocrLanguage

string

تعديل اللغة لمعالجة التعرّف البصري على الأحرف (OCR) أثناء استيراد الصور (رمز ISO 639-1).

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

includePermissionsForView

string

تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يمكن استخدام الحالة "المنشورة" فقط.

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
  • https://www.googleapis.com/auth/drive.photos.readonly

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