Method: files.copy

ينشئ نسخة من ملف ويطبّق أي تحديثات مطلوبة باستخدام دلالات التصحيح. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء الملفات وإدارتها.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
enforceSingleParent
(deprecated)

boolean

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

boolean

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

boolean

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

string

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

boolean

تُستخدَم لتحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
includePermissionsForView

string

تحدّد هذه السمة أذونات العرض الإضافية التي سيتم تضمينها في الردّ. يُسمح فقط بالقيمة published.
includeLabels

string

قائمة قيم مفصولة بفاصلة تتضمّن معرّفات التصنيفات المطلوب تضمينها في الجزء labelInfo من الردّ.
copyComments

boolean

لتحديد ما إذا كان سيتم نسخ التعليقات المفتوحة (التي لم يتم حلّها) المرتبطة بالملف.

نص الطلب

يحتوي نص الطلب على مثال 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

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