Method: files.update

تعدّل هذه الطريقة البيانات الوصفية لملف أو محتواه أو كليهما.

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

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

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

    (يُرجى تحديد نوع MIME صالح بدلاً من القيمة الحرفية */*. يُستخدم الحرف */* فقط للإشارة إلى أنّه يمكن تحميل أي نوع MIME صالح. لمزيد من المعلومات، يُرجى الاطّلاع على أنواع MIME المتوافقة في Google Workspace وGoogle Drive).

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

طلب HTTP

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

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

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

المعلمات
fileId

string

رقم تعريف الملف

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

المعلمات
addParents

string

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

boolean

تم إيقاف الميزة: لم يعُد مسموحًا بإضافة ملفات إلى مجلدات متعددة. استخدِم الاختصارات بدلاً من ذلك.
keepRevisionForever

boolean

تحديد ما إذا كان سيتم ضبط الحقل keepForever في أحدث نسخة من العنوان لا ينطبق هذا الخيار إلا على الملفات ذات المحتوى الثنائي في Google Drive. يمكن الاحتفاظ بـ 200 نسخة سابقة فقط من الملف إلى الأبد. في حال بلوغ الحدّ الأقصى، جرِّب حذف المراجعات المثبّتة.
ocrLanguage

string

تلميح لغة لمعالجة التعرّف البصري على الحروف أثناء استيراد الصور (رمز ISO 639-1).
removeParents

string

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

boolean

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

boolean

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

string

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

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

boolean

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

string

تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح فقط بالقيمة published.
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

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