Method: files.watch

الاشتراك في التغييرات التي يتم إجراؤها على ملف

طلب HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/watch

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

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

المعلمات
fileId

string

رقم تعريف الملف المعنيّ.

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

المعلمات
supportsAllDrives

boolean

ما إذا كان التطبيق الذي قدّم الطلب يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

متوقّفة نهائيًا: استخدِم supportsAllDrives بدلاً منها.

acknowledgeAbuse

boolean

ما إذا كان المستخدم يقرّ بمخاطر تنزيل برامج ضارة معروفة أو ملفات مسيئة أخرى لا ينطبق ذلك إلا في حال ضبط مَعلمة alt على media، وعندما يكون المستخدم هو مالك الملف أو منظِّمًا لمساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف.

includePermissionsForView

string

لتحديد أذونات الملف الشخصي الإضافية التي يجب تضمينها في الرد. يُسمَح باستخدام published فقط.

revisionId

string

تحدد معرف النسخة السابقة الذي يجب تنزيله. يتم تجاهل السياسة ما لم يتم تحديد alt=media.

updateViewedDate
(deprecated)

boolean

متوقّفة نهائيًا: يجب استخدام file.update مع updatedDateBehavior=noChange وupdateViewedDate=true ونص طلب فارغ.

projection
(deprecated)

enum (Projection)

متوقّفة نهائيًا: لا تتضمّن هذه المَعلمة أي وظيفة.

includeLabels

string

قائمة بمعرّفات التصنيفات المفصولة بفواصل التي يجب تضمينها في الجزء labelInfo من الردّ.

نص الطلب

يحتوي نص الطلب على مثال Channel.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Channel.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات 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.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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