Method: files.create

لإنشاء ملف جديد.

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

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

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

للحصول على مزيد من المعلومات حول تحميل الملفات، يمكنك الاطّلاع على تحميل بيانات الملفات.

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المعلّمات
uploadType

string

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

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

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

boolean

تمّ الإيقاف. لم يعد إنشاء الملفات في مجلدات متعددة متاحًا.
ignoreDefaultVisibility

boolean

ما إذا كان سيتم تجاهل إعدادات إذن الوصول التلقائية للملف الذي تم إنشاؤه للنطاق. يمكن لمشرفي النطاق اختيار جعل جميع الملفات التي تم تحميلها مرئية للنطاق بشكل تلقائي، تتجاوز هذه المعلمة هذا السلوك في الطلب. ستظل الأذونات مكتسبة من المجلدات الرئيسية.
keepRevisionForever

boolean

لتحديد ما إذا كنت تريد ضبط الحقل "keepforever" في النسخة الجديدة من عنوان الرأس. ينطبق هذا فقط على الملفات التي تتضمن محتوى ثنائيًا في Google Drive. يمكن الاحتفاظ 200 نسخة سابقة فقط من الملف للملف للأبد. في حال بلوغ الحدّ الأقصى المسموح به، يمكنك تجربة حذف النُسخ السابقة المثبّتة.
ocrLanguage

string

تلميح لغة لمعالجة التعرّف البصري على الأحرف أثناء استيراد الصور (رمز ISO 639-1)
supportsAllDrives

boolean

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

boolean

تم الإيقاف: استخدِم supportsAllDrives بدلاً من ذلك.
useContentAsIndexableText

boolean

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

string

يحدد أذونات الملفات الشخصية الإضافية التي يجب تضمينها في الرد. الخيار "منشور" فقط.
includeLabels

string

تمثّل هذه السمة قائمة بمعرّفات التصنيفات مفصولة بفواصل لتضمينها في الجزء labelInfo من الرد.

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

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

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