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

الحد الأقصى لعدد التغييرات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذا العدد.

إذا لم يتم تحديد هذه المَعلمة، سيتم عرض 100 تغيير على الأكثر.

الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم التي تزيد عن 1000.
pageToken

string

الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية. يجب ضبط هذه المَعلمة على قيمة "nextPageToken" من الاستجابة السابقة أو على الاستجابة من طريقة getStartPageToken.
restrictToMyDrive

boolean

ما إذا كان يجب حصر النتائج على التغييرات داخل التسلسل الهرمي لمجلد "ملفاتي". يؤدي ذلك إلى استبعاد التغييرات التي تطرأ على ملفات، مثل الملفات في مجلد "بيانات التطبيق" أو الملفات المشترَكة التي لم تتم إضافتها إلى "ملفاتي".
spaces

string

قائمة مفصولة بفواصل للمساحات المطلوب طلب البحث عنها في النصوص. القيمتان المسموح بهما هما "drive" و"appDataFolder".
supportsAllDrives

boolean

ما إذا كان التطبيق الذي يطلب البيانات يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه المَعلمة. يُرجى استخدام supportsAllDrives بدلاً منها.
teamDriveId
(deprecated)

string

تم إيقاف هذه المَعلمة. يُرجى استخدام driveId بدلاً منها.
includePermissionsForView

string

تحدّد هذه المَعلمة أذونات العرض الإضافية المطلوب تضمينها في الاستجابة. يُسمح فقط بالقيمة "published".
includeLabels

string

قائمة مفصولة بفواصل لأرقام تعريف التصنيفات المطلوب تضمينها في جزء labelInfo من الاستجابة.

نص الطلب

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

نص الاستجابة

قائمة بالتغييرات التي أجراها مستخدم.

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

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

object (Change)

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

string

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

string

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

string

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

نطاقات الأذونات

يجب توفير أحد نطاقات 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

بعض النطاقات مقيّدة وتتطلب إجراء تقييم أمني لتطبيقك كي يتمكّن من استخدامها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.