Method: changes.list

تعرض هذه السمة التغييرات التي أجراها مستخدم أو مساحة Drive مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على استرداد التغييرات.

طلب 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

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

string

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

boolean

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

boolean

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

string

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

string

تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح بالقيمة "منشور" فقط.
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

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