Method: files.patch

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

طلب 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

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

boolean

لتحديد ما إذا كنت تريد تجربة التعرّف البصري على الأحرف (OCR) على عمليات تحميل .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

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