الاشتراك في التغييرات لمستخدم
طلب HTTP
POST https://www.googleapis.com/drive/v3/changes/watch
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
driveId |
مساحة التخزين السحابي المشتركة التي سيتم عرض التغييرات منها. في حال تحديد أرقام تعريف التغييرات التي ستعكس مساحة التخزين السحابي المشتركة، استخدِم رقم تعريف مساحة التخزين السحابي المشترَكة ورقم تعريف التغيير كمعرِّف. |
includeCorpusRemovals |
ما إذا كان يجب أن تتضمن التغييرات مورد الملف إذا كان المستخدم لا يزال بإمكانه الوصول إلى الملف في وقت الطلب، حتى بعد إزالة الملف من قائمة التغييرات ولن تكون هناك أي إدخالات أخرى لتغيير هذا الملف. |
includeItemsFromAllDrives |
يمكنك اختيار ما إذا كان يجب تضمين كل من "ملفاتي" والعناصر في مساحة التخزين السحابي المشتركة في النتائج. |
includeRemoved |
لتحديد ما إذا كان سيتم تضمين تغييرات تشير إلى إزالة عناصر من قائمة التغييرات، على سبيل المثال عن طريق الحذف أو فقدان الوصول. |
includeTeamDriveItems |
متوقّفة نهائيًا: يمكنك استخدام |
pageSize |
الحد الأقصى لعدد التغييرات المطلوب عرضها في كل صفحة. |
pageToken |
الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية ويجب ضبط هذا على قيمة "nextPageToken" من الاستجابة السابقة أو على الاستجابة من طريقة getStartPageToken. |
restrictToMyDrive |
يمكنك اختيار ما إذا كان سيتم تقييد النتائج بالتغييرات داخل التدرّج الهرمي "ملفاتي". يؤدي ذلك إلى حذف التغييرات التي تم إجراؤها على الملفات، مثل الملفات في مجلد Application Data (بيانات التطبيق) أو الملفات المشتركة التي لم تتم إضافتها إلى "ملفاتي". |
spaces |
قائمة بمسافات مفصولة بفواصل للاستعلام داخل المجموعة. القيمتان المسموح بإدراجهما هما "drive" و"appDataالمجلد". |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
متوقّفة نهائيًا: يمكنك استخدام |
teamDriveId |
متوقّفة نهائيًا: يمكنك استخدام |
includePermissionsForView |
تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يمكن استخدام الحالة "المنشورة" فقط. |
includeLabels |
قائمة مفصولة بفواصل تضم معرّفات التصنيفات المراد تضمينها في الجزء |
نص الطلب
يحتوي نص الطلب على مثال 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
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.