Method: changes.list

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
driveId

string

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

includeCorpusRemovals

boolean

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

includeItemsFromAllDrives

boolean

ما إذا كان يجب تضمين كل من عناصر "ملفاتي" ومساحة التخزين السحابي المشتركة في النتائج.

includeRemoved

boolean

ما إذا كان سيتم تضمين تغييرات تشير إلى إزالة العناصر من قائمة التغييرات، مثلاً عن طريق الحذف أو فقدان إمكانية الوصول.

includeTeamDriveItems
(deprecated)

boolean

متوقّفة نهائيًا: استخدِم includeItemsFromAllDrives بدلاً منها.

pageSize

integer

الحدّ الأقصى لعدد التغييرات المطلوب عرضها لكل صفحة.

pageToken

string

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

restrictToMyDrive

boolean

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

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.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

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