Method: files.copy

يؤدّي هذا الإجراء إلى إنشاء نسخة من الملف وتطبيق أي تعديلات مطلوبة باستخدام الترميز الدلالي.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
fileId

string

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

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

المعلّمات
enforceSingleParent

boolean

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

boolean

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

boolean

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

string

تلميح لغة لمعالجة التعرّف البصري على الأحرف أثناء استيراد الصور (رمز 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

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