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

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

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

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

المعلمات
convert

boolean

تحديد ما إذا كان سيتم تحويل هذا الملف إلى تنسيق "أدوات تحرير المستندات" المناسب
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

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