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