Method: changes.list

يسرد التغييرات لمستخدم أو مساحة تخزين سحابي مشتركة.

طلب HTTP

GET https://www.googleapis.com/drive/v3/changes

يستخدِم عنوان 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 من الإجابة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة التغييرات لأحد المستخدمين.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
الحقول
kind

string

تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#changeList".

nextPageToken

string

الرمز المميز للصفحة للصفحة التالية من التغييرات. لن يكون هذا الخيار متاحًا في حال الوصول إلى نهاية قائمة التغييرات. لا تنتهي صلاحية الرمز المميّز للصفحة.

newStartPageToken

string

الرمز المميّز لصفحة البداية من أجل التغييرات المستقبلية. لن تظهر هذه التغييرات إلا إذا تم الوصول إلى نهاية قائمة التغييرات الحالية. لا تنتهي صلاحية الرمز المميّز للصفحة.

changes[]

object (Change)

قائمة التغييرات. في حال تعبئة NextPageToken، قد تكون هذه القائمة غير مكتملة وسيتم جلب صفحة إضافية من النتائج.

نطاقات التفويض

يتطلب استخدام أحد نطاقات 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

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