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

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