Method: files.create

• طلب HTTP
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

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

تتوافق هذه الطريقة مع معرّف الموارد المنتظم (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

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