Method: files.insert

إدراج ملف جديد

تتيح هذه الطريقة استخدام معرّف الموارد المنتظم /upload وقبول الوسائط المحمَّلة التي تتضمّن السمات التالية:

  • الحد الأقصى لحجم الملف: 5,120 غيغابايت
  • أنواع MIME المقبولة للوسائط:*/*

ملاحظة: حدِّد نوع MIME صالحًا بدلاً من القيمة الحرفية */*. لا يُستخدَم الرمز */* إلا للإشارة إلى أنّه يمكن تحميل أي نوع صالح من أنواع MIME.

لمزيد من المعلومات عن تحميل الملفات، اطّلِع على مقالة تحميل بيانات الملفات.

على التطبيقات التي تنشئ اختصارات باستخدام files.insert تحديد نوع MIME application/vnd.google-apps.shortcut.

على التطبيقات تحديد امتداد ملف في السمة title عند إدراج الملفات باستخدام واجهة برمجة التطبيقات. على سبيل المثال، يجب أن تحدّد عملية إدراج ملف JPEG رمزًا مثل "title": "cat.jpg" في البيانات الوصفية.

تتضمّن طلبات GET اللاحقة السمة fileExtension للقراءة فقط التي تمّت تعبئتها بالإضافة المحدّدة في الأصل في السمة title. عندما يطلب مستخدم Google Drive تنزيل ملف، أو عندما يتم تنزيل الملف من خلال برنامج مزامنة، ينشئ Drive اسم ملف كاملاً (مع امتداد) استنادًا إلى العنوان. في الحالات التي لا يتوفّر فيها امتداد الملف، يحاول Drive تحديده استنادًا إلى نوع MIME للملف.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    POST https://www.googleapis.com/upload/drive/v2/files
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، للطلبات المتعلّقة بالبيانات الوصفية فقط:
    POST https://www.googleapis.com/drive/v2/files

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات طلب البحث

المعلمات
convert

boolean

ما إذا كان سيتم تحويل هذا الملف إلى تنسيق "أدوات تحرير مستندات Google" المقابل
enforceSingleParent
(deprecated)

boolean

ميزة متوقّفة نهائيًا: لم يعُد بإمكانك إنشاء ملفات في مجلدات متعددة.
ocr

boolean

يحدد هذا الخيار ما إذا كنت تريد محاولة استخدام تقنية التعرّف البصري على الأحرف في ملفات jpg .أو png. أو gif. أو pdf .التي تحمّلها.
ocrLanguage

string

إذا كان OCR صحيحًا، يشير إلى اللغة التي يجب استخدامها. القيم الصالحة هي رموز BCP 47.
pinned

boolean

ما إذا كان سيتم تثبيت النسخة الرئيسية من الملف الذي تم تحميله. يمكن أن يحتوي الملف على 200 نسخة سابقة تم تثبيتها كحد أقصى.
supportsAllDrives

boolean

ما إذا كان التطبيق الذي يطلب الوصول يتوافق مع "ملفاتي" ومساحات التخزين السحابي المشتركة
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام supportsAllDrives بدلاً منها.
timedTextLanguage

string

لغة النص الموقّت
timedTextTrackName

string

اسم مسار النص الموقّت
uploadType

string

نوع طلب التحميل إلى معرّف الموارد المنتظِم /upload إذا كنت تحمّل بيانات باستخدام معرّف موارد منتظم /upload، يكون هذا الحقل مطلوبًا. إذا كنت تنشئ ملفًا يتضمّن بيانات وصفية فقط، لن يكون هذا الحقل مطلوبًا. بالإضافة إلى ذلك، لا يظهر هذا الحقل في التطبيق المصغّر "تجربة هذه الطريقة" لأنّ التطبيق المصغّر لا يتيح تحميل البيانات.

القيم المقبولة هي:
useContentAsIndexableText

boolean

ما إذا كان سيتم استخدام المحتوى كنص قابل للفهرسة
visibility

enum (Visibility)

إذن الوصول إلى الملف الجديد لا تكون هذه المَعلمة ذات صلة إلا عندما تكون قيمة convert=false.
includePermissionsForView

string

تُحدِّد أذونات العرض الإضافية المطلوب تضمينها في الاستجابة. يُسمح فقط بالقيمة published.
includeLabels

string

قائمة مفصولة بفواصل بأرقام تعريف التصنيفات المطلوب تضمينها في جزء labelInfo من الاستجابة

نص الطلب

يحتوي نص الطلب على مثال File.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال File.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file

تكون بعض النطاقات محظورة وتتطلّب تقييم أمان ليتمكّن تطبيقك من استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.