يوضح هذا الدليل كيفية إنشاء الملفات وإدارتها في 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 API مناسب للسماح بالطلب. لمزيد من المعلومات عن نطاقات Drive، يُرجى الاطِّلاع على اختيار نطاقات Google Drive API.
الحدود والاعتبارات
أثناء التحضير لنسخ الملفات، لاحظ هذه الحدود والاعتبارات:
الأذونات:
- يحدّد قيد الملف
copyRequiresWriterPermission
المستخدمين الذين يمكنهم نسخ الملف. لمزيد من المعلومات، يمكنك الاطّلاع على منع المستخدمين من تنزيل ملفك أو طباعته أو نسخه. - ويحدِّد الحقل
capabilities/canCopy
لموردfiles
ما إذا كان بإمكان المستخدم نسخ ملف. ولمزيد من المعلومات، يُرجى الاطّلاع على الإمكانات. - يملك المستخدم الذي أنشأ النسخة الملف المنسوخ. لا يتم نسخ إعدادات مشاركة أخرى من الملف المصدر. إذا تم إنشاء النسخة في مجلد مشترك، فإنها تكتسب أذونات هذا المجلد.
- قد تتغير ملكية الملف المنسوخ، وقد لا تكتسب النسخة إعدادات مشاركة الملف الأصلي. قد تحتاج إلى إعادة تعيين هذه الإعدادات.
- يحدّد قيد الملف
إدارة الملفات:
- لا يمكن مطلقًا نسخ بعض الملفات، مثل الاختصارات التابعة لجهات خارجية.
- يمكنك نسخ الملف إلى مجلد رئيسي واحد فقط. ولا يُسمح بتحديد عدة
آباء. إذا لم يتم تحديد الحقل
parents
، سيكتسب الملف أي عناصر رئيسية قابلة للاكتشاف من الملف المصدر. - وعلى الرغم من أنّ المجلد هو نوع من الملفات، لا يمكنك نسخه.
بدلاً من ذلك، يمكنك إنشاء مجلد وجهة وضبط الحقل
parents
للملفات الحالية على مجلد الوجهة. يمكنك بعد ذلك حذف مجلد المصدر الأصلي. - ما لم يتم تحديد اسم ملف جديد، تنتج الطريقة
files.copy
ملفًا يحمل اسم الملف الأصلي نفسه. - قد يؤدي الاستخدام المفرط لواجهة برمجة التطبيقات
files.copy
إلى تجاوز حدود حصة واجهة برمجة التطبيقات في Drive. لمزيد من المعلومات، راجِع حدود الاستخدام.
مواضيع ذات صلة
في ما يلي بعض الخطوات التالية التي يمكنك تجربتها:
لتحميل بيانات الملف عند إنشاء ملف أو تعديله، يُرجى مراجعة تحميل بيانات الملف.
لإنشاء ملف في مجلد معيّن، راجِع إنشاء ملف في مجلد معيّن.
للعمل على البيانات الوصفية للملفات، يُرجى الاطّلاع على إدارة البيانات الوصفية للملفات.
لحذف ملف، يُرجى الاطّلاع على المهملات أو حذف الملفات والمجلدات.