Method: changes.watch

الاشتراك في التغييرات التي يجريها مستخدم

طلب HTTP

POST https://www.googleapis.com/drive/v3/changes/watch

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

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

المعلمات
driveId

string

مساحة التخزين السحابي المشتركة التي سيتم عرض التغييرات منها. في حال تحديد أرقام تعريف التغيير، ستعكس مساحة التخزين السحابي المشتركة. استخدِم رقم تعريف مساحة التخزين السحابي المجمّع ورقم تعريف التغيير كمعرّف.

includeCorpusRemovals

boolean

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

includeItemsFromAllDrives

boolean

ما إذا كان يجب تضمين كل من عناصر "ملفاتي" ومساحة التخزين السحابي المشتركة في النتائج.

includeRemoved

boolean

ما إذا كان سيتم تضمين تغييرات تشير إلى إزالة العناصر من قائمة التغييرات، مثلاً عن طريق الحذف أو فقدان إمكانية الوصول.

includeTeamDriveItems
(deprecated)

boolean

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

pageSize

integer

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

pageToken

string

الرمز المميز لمتابعة طلب قائمة سابق في الصفحة التالية. يجب ضبط هذا الرمز على قيمة "nextPageToken" من الاستجابة السابقة أو على الاستجابة في طريقة getStartPageToken.

restrictToMyDrive

boolean

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

spaces

string

قائمة بمسافات مفصولة بفواصل للاستعلام داخل المجموعات. القيمتان المسموح بهما هما "drive" و"appDataمجلد".

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

لتحديد أذونات الملف الشخصي الإضافية التي يجب تضمينها في الرد. ولا تتم إتاحة سوى الحالة "منشور".

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

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