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