Method: files.update

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

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

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

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

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

طلب HTTP

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

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

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

المعلمات
fileId

string

رقم تعريف الملف المطلوب تعديله.

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

المعلمات
addParents

string

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

boolean

متوقّفة نهائيًا: لا تُستخدَم هذه المَعلمة.
enforceSingleParent
(deprecated)

boolean

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

enum (ModifiedDateBehavior)

تحدّد السلوك الذي يتمّ به تعديل modifiedDate. تؤدي هذه السياسة إلى إلغاء setModifiedDate.
newRevision

boolean

ما إذا كان يجب أن يؤدي تحميل ملف نصي إلى إنشاء نسخة جديدة. إذا كان القيمة خطأ، يتم استبدال بيانات العنصر المصغّر في المراجعة الحالية للملف الرئيسي. إذا كان صحيحًا أو لم يتم ضبطه، يتم إنشاء قطعة بيانات جديدة كمراجعة رئيسية، ويتم الاحتفاظ بالمراجعات السابقة غير المثبَّتة لفترة قصيرة من الوقت. يتم تخزين النُسخ المثبَّتة إلى أجل غير مسمى باستخدام حصة تخزين إضافية، ويصل الحد الأقصى إلى 200 نسخة. لمعرفة تفاصيل عن كيفية الاحتفاظ بالمراجعات، يُرجى الاطّلاع على مركز مساعدة Drive.
ocr

boolean

يحدد هذا الخيار ما إذا كنت تريد محاولة استخدام ميزة التعرّف البصري على الأحرف في ملفات jpg .أو png. أو gif. أو pdf .التي تحمّلها.
ocrLanguage

string

إذا كان OCR صحيحًا، يشير إلى اللغة التي يجب استخدامها. القيم الصالحة هي رموز BCP 47.
pinned

boolean

ما إذا كنت تريد تثبيت النسخة الجديدة يمكن أن يحتوي الملف على 200 نسخة سابقة تم تثبيتها كحد أقصى.
removeParents

string

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

boolean

ما إذا كان سيتم ضبط التاريخ المعدَّل باستخدام القيمة المقدَّمة في نص الطلب. إنّ ضبط هذا الحقل على true يعادل modifiedDateBehavior=fromBodyOrNow، وfalse يعادل modifiedDateBehavior=now. لمنع أي تغييرات على التاريخ المعدَّل، اضبط modifiedDateBehavior=noChange.
supportsAllDrives

boolean

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

boolean

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

string

لغة النص الموقّت
timedTextTrackName

string

اسم مسار النص الموقّت
updateViewedDate

boolean

ما إذا كان سيتم تعديل تاريخ العرض بعد تعديل الملف بنجاح
uploadType

string

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

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

boolean

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

string

تُحدِّد أذونات العرض الإضافية المطلوب تضمينها في الاستجابة. يُسمح فقط بالقيمة published.
includeLabels

string

قائمة مفصولة بفواصل بأرقام تعريف التصنيفات المطلوب تضمينها في جزء labelInfo من الاستجابة

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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