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

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

إنشاء ملف

لإنشاء ملف في Drive لا يحتوي على بيانات وصفية أو محتوى، استخدِم طريقة create في مورد files بدون مَعلمات.

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

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

استخدام المَعلمة fields

إذا أردت تحديد الحقول التي سيتم عرضها في الردّ، يمكنك ضبط المَعلمة fields system باستخدام أي طريقة من طرق المورد files. في حال حذف المَعلمة fields، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. على سبيل المثال، تعرض الطريقة list الحقول kind وid وname وmimeType وresourceKey فقط لكل ملف. لعرض حقول مختلفة، راجِع عرض حقول محدّدة.

إنشاء أرقام تعريف لاستخدامها مع ملفاتك

تتيح لك الطريقة generateIds في المورد files إنشاء معرّفات فريدة للملفات مسبقًا، ويمكن استخدامها عند إنشاء الملفات والمجلدات أو نسخها في Drive. يمكن أن يكون هذا مفيدًا عندما تحتاج إلى التحكّم في معرّفات الملفات من تطبيقك، بدلاً من السماح لـ Drive بتعيينها تلقائيًا.

يمكنك ضبط عدد المعرّفات التي يتم إنشاؤها باستخدام مَعلمة طلب البحث count. إذا لم يتم ضبط count، سيتم عرض 10 نتائج تلقائيًا. يبلغ الحدّ الأقصى لعدد المعرّفات التي يمكنك طلبها 1,000 معرّف.

يمكنك أيضًا تحديد space التي يمكن استخدام المعرّفات فيها وtype العناصر التي يمكن استخدام المعرّفات فيها.

بعد إنشاء معرّف، يمكن تمريره إلى الطريقتَين create أو copy من خلال الحقل id. يضمن ذلك أنّ الملف الذي تم إنشاؤه أو نسخه يستخدم المعرّف المحدّد مسبقًا.

في حال تم إنشاء الملف أو نسخه بنجاح، ستعرض المحاولات اللاحقة رمز حالة HTTP‏ 409 Conflict ولن يتم إنشاء ملفات مكرّرة.

يُرجى العِلم أنّه لا يمكن استخدام المعرّفات التي تم إنشاؤها مسبقًا لإنشاء ملفات Google Workspace، باستثناء application/vnd.google-apps.drive-sdk وapplication/vnd.google-apps.folder أنواع MIME. وبالمثل، لا تتوفّر عمليات التحميل التي تشير إلى تحويل إلى تنسيق ملف Google Workspace.

إنشاء ملفات تحتوي على البيانات الوصفية فقط

لا تحتوي الملفات التي تتضمّن البيانات الوصفية فقط على أي محتوى. بيانات التعريف هي البيانات (مثل name وmimeType وcreatedTime) التي تصف الملف. الحقول مثل name لا ترتبط بمستخدم معيّن وتظهر بشكل مماثل لكل مستخدم، بينما الحقول مثل viewedByMeTime تحتوي على قيم خاصة بالمستخدم.

أحد الأمثلة على ملف البيانات الوصفية فقط هو مجلد من نوع MIME application/vnd.google-apps.folder. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المجلدات وتعبئتها. مثال آخر هو اختصار يشير إلى ملف آخر على Drive بنوع MIME application/vnd.google-apps.shortcut. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء اختصار إلى ملف في Drive.

إدارة الصور المصغّرة

تساعد الصور المصغّرة المستخدمين في التعرّف على ملفات Drive. يمكن لتطبيق Drive إنشاء صور مصغّرة تلقائيًا لأنواع الملفات الشائعة، أو يمكنك تقديم صورة مصغّرة أنشأها تطبيقك. لمزيد من المعلومات، راجِع مقالة تحميل الصور المصغّرة.

نسخ ملف حالي

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

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

يمكنك ضبط معرّف الملف الذي تم نسخه مسبقًا باستخدام طريقة generateIds. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أرقام تعريف لاستخدامها مع ملفاتك.

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

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

عند الاستعداد لنسخ الملفات، ضَع في اعتبارك الحدود والاعتبارات التالية:

• الأذونات:

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

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

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

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

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

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

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

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

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

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