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

يوضح هذا الدليل كيفية إنشاء الملفات وإدارتها في 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 من نوع MIME application/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. لمزيد من المعلومات، راجِع حدود الاستخدام.

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

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

• لتحميل بيانات الملف عند إنشاء ملف أو تعديله، يُرجى مراجعة تحميل بيانات الملف.

• لإنشاء ملف في مجلد معيّن، راجِع إنشاء ملف في مجلد معيّن.

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

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