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

يشرح هذا الدليل كيفية إنشاء الملفات وإدارتها في Google Drive باستخدام Google Drive API.

إنشاء ملف

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

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

عند الاستعداد لنسخ الملفات، يُرجى الانتباه إلى هذه الحدود والاعتبارات:

• الأذونات:

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

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

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

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

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

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

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

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

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

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