Method: files.patch

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

طلب HTTP

PATCH 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

ما إذا كان سيتم تعديل تاريخ العرض بعد تعديل الملف بنجاح
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

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