إنشاء الملفات وإدارتها

يوضّح هذا الدليل كيفية إنشاء الملفات وإدارتها في Google Drive.

إنشاء ملف

لإنشاء ملف في Drive لا يحتوي على بيانات وصفية أو محتوى، استخدِم طريقة files.create() بدون مَعلمات. يتم منح الملف kind من drive.file وid وname من "Untitled" وmimeType من application/octet-stream. تم وضع علامة على uploadType بأنّها مطلوبة، ولكنّها يتم ضبطها تلقائيًا على media، لذا ليس عليك تقديم هذه السمة.

لمزيد من المعلومات عن الحدود القصوى لملفات Drive، يُرجى الاطّلاع على الحدود القصوى للملفات والمجلدات.

ملاحظة: عندما يريد مستخدم Drive تنزيل ملف أو عندما يتم تنزيله من خلال برنامج مزامنة، ينشئ Drive اسم ملف كاملاً (مع امتداد) استنادًا إلى الاسم. في الحالات التي لا يتوفّر فيها امتداد الملف، يحاول Drive تحديده استنادًا إلى نوع MIME للملف.

إنشاء ملفات تتضمّن بيانات وصفية فقط

لا تحتوي الملفات التي تتضمّن بيانات وصفية فقط على أي محتوى. البيانات الوصفية هي بيانات (مثل name mimeType وcreatedTime) تصف الملف. إنّ الحقول مثل name هي حقول لا تعتمد على المستخدم وتظهر بالطريقة نفسها لكل مستخدم، في حين أنّ الحقول مثل viewedByMeTime تحتوي على قيم خاصة بالمستخدم.

من الأمثلة على الملفات التي تتضمّن بيانات وصفية فقط المجلد الذي يحتوي على نوع MIME application/vnd.google-apps.folder. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المجلدات وملؤها. ومن الأمثلة الأخرى اختصار يشير إلى ملف آخر على Drive بنوع MIMEapplication/vnd.google-apps.shortcut. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء اختصار لملف في Drive.

إدارة الصور المصغّرة

تساعد الصور المصغّرة المستخدمين في التعرّف على ملفات Drive. يمكن أن ينشئ Drive صورًا مصغّرة تلقائيًا لأنواع الملفات الشائعة، أو يمكنك تقديم صورة مصغّرة أنشأها تطبيقك. لمزيد من المعلومات، اطّلِع على مقالة تحميل صور مصغّرة.

نسخ ملف حالي

لنسخ ملف وتطبيق أي تعديلات مطلوبة، استخدِم الطريقة files.copy(). للعثور على fileId المطلوب نسخه، استخدِم الطريقة التالية: files.list().

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

الحدود والاعتبارات

أثناء التحضير لنسخ الملفات، يُرجى مراعاة هذه الحدود والاعتبارات:

• الأذونات:

  • يحدّد تقييد الملف copyRequiresWriterPermission المستخدمين الذين يمكنهم نسخ الملف. لمزيد من المعلومات، يُرجى الاطّلاع على منع المستخدمين من تنزيل ملفك أو طباعته أو نسخه.
  • يحدِّد الحقل capabilities/canCopy لمورد files ما إذا كان بإمكان المستخدم نسخ ملف. لمزيد من المعلومات، اطّلِع على فهم إمكانات الملفات.
  • يملك المستخدم الذي أنشأ النسخة الملف المنسوخ. ولا تتم إعادة إنشاء أي إعدادات مشاركة أخرى من ملف المصدر. إذا تم إنشاء النسخة في مجلد مشترك، ستكتسب أذونات هذا المجلد.
  • قد تتغير ملكية الملف المنسوخ وقد لا تكتسب النسخة إعدادات المشاركة الخاصة بالملف الأصلي. قد تحتاج إلى إعادة ضبط هذه الإعدادات.

• إدارة الملفات:

  • لا يمكن أبدًا نسخ بعض الملفات، مثل اختصارات التطبيقات التابعة لجهات خارجية.
  • يمكنك نسخ ملف إلى مجلد رئيسي واحد فقط. لا يمكن تحديد عدة عناصر رئيسية. في حال عدم تحديد الحقل parents، يكتسب الملف أي عناصر رئيسية قابلة للاكتشاف من الملف المصدر.
  • على الرغم من أنّ المجلد هو نوع من الملفات، لا يمكنك نسخه. بدلاً من ذلك، أنشئ مجلد وجهة واضبط الحقل parents في الملفات الحالية على المجلد الوجهة. يمكنك بعد ذلك حذف المجلد المصدر الأصلي.
  • ما لم يتم تحديد اسم ملف جديد، تُنشئ الطريقة files.copy()ملفًا بالاسم نفسه المستخدَم في الملف الأصلي.
  • يمكن أن يؤدي الاستخدام المفرط لواجهة برمجة التطبيقات files.copy() إلى تجاوز حدود حصة واجهة برمجة التطبيقات Drive API. لمزيد من المعلومات، يُرجى الاطّلاع على حدود الاستخدام.

مواضيع ذات صلة

في ما يلي بعض الخطوات التالية التي يمكنك تجربتها:

• لتحميل بيانات الملف عند إنشاء ملف أو تعديله، اطّلِع على مقالة تحميل بيانات الملف.

• لإنشاء ملف في مجلد معيّن، اطّلِع على مقالة إنشاء ملف في مجلد معيّن.

• لنقل الملفات، يُرجى الاطّلاع على مقالة نقل الملفات بين المجلدات.

• للعمل مع البيانات الوصفية للملف، يُرجى الاطّلاع على إدارة البيانات الوصفية للملف.

• لحذف ملف، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.