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

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

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