Method: changes.list

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

تم الإيقاف: استخدِم includeItemsFromAllDrives بدلاً من ذلك.
pageSize

integer

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

string

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

boolean

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

string

قائمة بمسافات للفصل بينها بفواصل. والقيمتان المسموح بإدراجهما هما "drive" و"appDataFolder".
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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