Method: files.update

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

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

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

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

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

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

طلب HTTP

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

تحديد ما إذا كان تحميل كائن ثنائي كبير الحجم يجب أن يؤدي إلى إنشاء نسخة جديدة إذا كانت القيمة false، سيتم استبدال بيانات blob في أحدث نسخة من المستند. إذا كانت القيمة صحيحة أو لم يتم ضبطها، يتم إنشاء كائن ثنائي كبير جديد كمراجعة رئيسية، ويتم الاحتفاظ بالمراجعات السابقة غير المثبّتة لفترة قصيرة من الوقت. يتم تخزين المراجعات المثبّتة إلى أجل غير مسمى، باستخدام مساحة التخزين المتوفّرة الإضافية، وبحد أقصى 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

تحديد ما إذا كان سيتم تعديل تاريخ العرض بعد تعديل الملف بنجاح
uploadType

string

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

القيم المقبولة هي:
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

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