Method: files.update

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

تتوافق هذه الطريقة مع معرّف الموارد المنتظم (URI) /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 Transcode.

معلّمات المسار

المعلّمات
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

تلميح لغة لمعالجة التعرّف البصري على الأحرف أثناء استيراد الصور (رمز 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

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