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" و"appDataFolder".
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

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