Method: files.update

تعديل البيانات الوصفية و/أو محتوى الملف عند استدعاء هذه الطريقة، املأ الحقول في الطلب التي تريد تعديلها فقط. عند تعديل الحقول، قد يتم تغيير بعض الحقول تلقائيًا، مثل modifiedDate. تتيح هذه الطريقة بنية التصحيح.

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

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

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

لمزيد من المعلومات عن تحميل الملفات، اطّلِع على مقالة تحميل بيانات الملفات.

طلب HTTP

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

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

مَعلمات المسار

المعلمات
fileId

string

رقم تعريف الملف

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

المعلمات
addParents

string

قائمة مفصولة بفواصل تتضمّن أرقام تعريف العناصر الرئيسية المطلوب إضافتها
enforceSingleParent
(deprecated)

boolean

ميزة متوقّفة نهائيًا: لم تعُد إضافة ملفات إلى مجلدات متعددة متاحة. استخدِم الاختصارات بدلاً من ذلك.
keepRevisionForever

boolean

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

string

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

string

قائمة مفصولة بفواصل تتضمّن أرقام تعريف العناصر الرئيسية المطلوب إزالتها
supportsAllDrives

boolean

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

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام supportsAllDrives بدلاً منها.
uploadType

string

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

القيم المقبولة هي:
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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