لإنشاء ملف جديد.
تتوافق هذه الطريقة مع معرّف الموارد المنتظم (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 |
نوع طلب التحميل إلى معرّف الموارد المنتظم (URI) للسمة القيم المقبولة هي:
|
enforceSingleParent |
تمّ الإيقاف. لم يعد إنشاء الملفات في مجلدات متعددة متاحًا. |
ignoreDefaultVisibility |
ما إذا كان سيتم تجاهل إعدادات إذن الوصول التلقائية للملف الذي تم إنشاؤه للنطاق. يمكن لمشرفي النطاق اختيار جعل جميع الملفات التي تم تحميلها مرئية للنطاق بشكل تلقائي، تتجاوز هذه المعلمة هذا السلوك في الطلب. ستظل الأذونات مكتسبة من المجلدات الرئيسية. |
keepRevisionForever |
لتحديد ما إذا كنت تريد ضبط الحقل "keepforever" في النسخة الجديدة من عنوان الرأس. ينطبق هذا فقط على الملفات التي تتضمن محتوى ثنائيًا في Google Drive. يمكن الاحتفاظ 200 نسخة سابقة فقط من الملف للملف للأبد. في حال بلوغ الحدّ الأقصى المسموح به، يمكنك تجربة حذف النُسخ السابقة المثبّتة. |
ocrLanguage |
تلميح لغة لمعالجة التعرّف البصري على الأحرف أثناء استيراد الصور (رمز ISO 639-1) |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدِّم الطلب يتيح استخدام "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
تم الإيقاف: استخدِم |
useContentAsIndexableText |
لتحديد ما إذا كان سيتم استخدام المحتوى الذي تم تحميله كنص قابل للفهرسة. |
includePermissionsForView |
يحدد أذونات الملفات الشخصية الإضافية التي يجب تضمينها في الرد. الخيار "منشور" فقط. |
includeLabels |
تمثّل هذه السمة قائمة بمعرّفات التصنيفات مفصولة بفواصل لتضمينها في الجزء |
نص الطلب
يحتوي نص الطلب على مثال File
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال File
.
نطاقات الأذونات
يتطلب ذلك أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
بعض النطاقات مقيَّدة وتتطلَّب تقييم أمان لكي يستخدمها تطبيقك. لمزيد من المعلومات، اطّلِع على دليل التفويض.