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

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

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

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