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

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

string

قائمة مفصولة بفواصل للمسافات التي سيتم البحث عنها ضمن النصوص القيم المسموح بها هي "drive" و"appDataFolder".
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.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

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