Method: files.update

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

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

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

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

لمزيد من المعلومات حول تحميل الملفات، راجع تحميل بيانات الملف.

طلب HTTP

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

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

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

المَعلمات
uploadType

string

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

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

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

string

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

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

المَعلمات
uploadType

string

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

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

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

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

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