Method: changes.list

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

طلب HTTP

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

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

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

المعلمات
driveId

string

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

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

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