Method: files.update

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

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

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

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

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

طلب HTTP

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

قائمة مفصولة بفواصل للمعرِّفات الرئيسية المطلوب إضافتها.
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

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