Method: changes.list

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

طلب HTTP

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

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

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

المَعلمات
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

integer

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

string

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

string

قائمة مفصولة بفواصل تحتوي على المسافات للاستعلام عنها. والقيمتان المسموح بإدراجهما هما drive وappDataFolder وphotos.
startChangeId
(deprecated)

string (int64 format)

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

boolean

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

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.
teamDriveId
(deprecated)

string

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

string

تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يُسمح فقط بالقيمة published.
includeLabels

string

قائمة مفصولة بفواصل تضم معرّفات التصنيفات المراد تضمينها في الجزء labelInfo من الإجابة.

نص الطلب

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

نص الاستجابة

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

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

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

string (int64 format)

رقم تعريف التغيير الأكبر الحالي
nextPageToken

string

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

string

دائمًا ما تكون drive#changeList.
etag

string

علامة ETag للقائمة.
newStartPageToken

string

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

object (Change)

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

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

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • 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

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