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

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

إنشاء ملف

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

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

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

لا تتضمّن ملفات البيانات الوصفية فقط أي محتوى. البيانات الوصفية هي بيانات (مثل 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 مناسب للسماح بالاتصال. لمزيد من المعلومات عن نطاقات Drive، يُرجى الاطّلاع على مقالة اختيار نطاقات Google Drive API.

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

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

  • الأذونات:

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

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

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

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