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

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

إنشاء ملف

لإنشاء ملف في Drive لا يتضمن بيانات وصفية أو محتوى، استخدم الطريقة files.create بدون المعلَمات. يتم منح الملف kind من drive.file، وid، بنسبة name من "بلا عنوان"، و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. القيادة يمكنها إنشاء صور مصغّرة تلقائيًا لأنواع الملفات الشائعة أو يمكنك تقديم صورة مصغّرة تم إنشاؤها بواسطة تطبيقك. لمزيد من المعلومات، راجع تحميل الصور المصغّرة.

نسخ ملف حالي

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

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

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

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

  • الأذونات:

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

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

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