Method: files.watch

للاشتراك في تلقّي إشعارات بشأن التغييرات التي يتم إجراؤها على ملف لمزيد من المعلومات، يُرجى الاطّلاع على الإشعارات المتعلقة بتغييرات الموارد.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
supportsAllDrives

boolean

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

boolean

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

boolean

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

string

تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح فقط بالقيمة published.
includeLabels

string

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

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

يجب توفير أحد نطاقات 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.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

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