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
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، لطلبات البيانات الوصفية فقط:
    POST https://www.googleapis.com/drive/v2/files

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

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

المَعلمات
uploadType

string

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

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

  • media - تحميل بسيط: تحميل الوسائط فقط، بدون أي بيانات وصفية
  • multipart - تحميل متعدد الأجزاء حمِّل كلاً من الوسائط والبيانات الوصفية الخاصة بها في طلب واحد.
  • resumable - تحميل قابل للاستئناف قم بتحميل الملف بطريقة قابلة للاستئناف، باستخدام سلسلة من طلبين على الأقل حيث يتضمن الطلب الأول البيانات الوصفية.
convert

boolean

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

boolean

مهملة: لم يعُد من الممكن إنشاء ملفات في مجلدات متعددة.
ocr

boolean

لتحديد ما إذا كنت تريد تجربة التعرّف البصري على الأحرف (OCR) على عمليات تحميل .jpg أو .png أو .gif أو .pdf.
ocrLanguage

string

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

boolean

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

boolean

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

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.
timedTextLanguage

string

لغة النص المحدد زمنيًا.
timedTextTrackName

string

اسم مسار النص المحدد زمنيًا.
useContentAsIndexableText

boolean

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

enum (Visibility)

مستوى رؤية الملف الجديد. تكون هذه المَعلمة ملائمة فقط عندما تكون conversion=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

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