Method: changes.watch

الاشتراك في التغيرات لأحد المستخدمين

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المعلّمات
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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