Method: changes.list

تعرض هذه السمة التغييرات التي أجراها مستخدم أو مساحة Drive مشتركة.

طلب 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 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
الحقول
items[]

object (Change)

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

string (int64 format)

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

string

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

string

يكون هذا الخيار drive#changeList دائمًا.
etag

string

تمثّل هذه السمة علامة ETag الخاصة بالقائمة.
newStartPageToken

string

الرمز المميز لصفحة البدء للتغييرات المستقبلية. لن يظهر هذا الخيار إلا إذا تم الوصول إلى نهاية قائمة التغييرات الحالية.

نطاقات الأذونات

يجب توفير أحد نطاقات 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

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