Method: changes.watch

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

طلب HTTP

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

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

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

المعلمات
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

integer

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

string

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

string

قائمة مفصولة بفواصل تضمّ المسافات المطلوب طلبها. والقيم المسموح بإدراجها هي drive وappDataFolder وphotos.
startChangeId
(deprecated)

string (int64 format)

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

boolean

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

boolean

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

string

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

string

لتحديد أذونات الملف الشخصي الإضافية التي يجب تضمينها في الرد. يُسمَح باستخدام published فقط.
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.apps.readonly
  • 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

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