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

الحد الأقصى لعدد التغييرات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة.

إذا لم يتم تحديد هذه المَعلمة، سيتم عرض 100 تغيير على الأكثر.

الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم التي تزيد عن 1000.
pageToken

string

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

boolean

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

string

قائمة مفصولة بفواصل للمساحات المطلوب طلب البحث عنها في المجموعات القيمتان المسموح بهما هما "drive" و"appDataFolder".
supportsAllDrives

boolean

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

boolean

تم إيقاف هذه المَعلمة: استخدِم supportsAllDrives بدلاً منها.
teamDriveId
(deprecated)

string

تم إيقاف هذه المَعلمة: استخدِم driveId بدلاً منها.
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

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