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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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