إنشاء ملفات

لإنشاء ملف لا يحتوي على بيانات وصفية أو محتوى، استخدِم طريقة 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 تلقائيًا صورًا مصغرة للعديد من أنواع الملفات الشائعة، مثل مستندات Google وجداول البيانات والعروض التقديمية. تساعد الصور المصغّرة المستخدم في التعرّف على ملفات Drive بشكل أفضل.

بالنسبة إلى أنواع الملفات التي يتعذّر على Drive إنشاء صورة مصغّرة عادية لها، يمكنك توفير صورة مصغّرة يتم إنشاؤها بواسطة تطبيقك. أثناء إنشاء الملف أو تعديله، يمكنك تحميل صورة مصغّرة من خلال ضبط الحقل contentHints.thumbnail على المورد files.

وهذه القيود تحديدًا هي كالآتي:

  • اضبط الحقل contentHints.thumbnail.image على عنوان URL واسم الملف بطريقة آمنة بترميز base64 (راجِع القسم RFC 4648 5).
  • اضبط الحقل contentHints.thumbnail.mimeType على نوع MIME المناسب للصورة المصغّرة.

إذا كان بإمكان Drive إنشاء صورة مصغّرة من الملف، فإنه يستخدم الصورة التي تم إنشاؤها تلقائيًا ويتجاهل أي صورة حمَّلتها. إذا لم يتمكن من إنشاء صورة مصغّرة، يتم استخدام الصورة التي تقدّمها

يجب أن تلتزم الصور المصغّرة بالقواعد التالية:

  • يمكن تحميلها بتنسيق PNG أو GIF أو JPG.
  • العرض الموصى به هو 1600 بكسل.
  • الحد الأدنى للعرض هو 220 بكسل.
  • الحد الأقصى لحجم الملف هو 2 ميغابايت.
  • ويجب أن يعدّلها التطبيق مع كل عملية حفظ.

لمزيد من المعلومات، يُرجى الاطّلاع على المرجع files.

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