بالنسبة إلى تطبيقات Google Drive التي يجب أن تتتبّع التغييرات على الملفات، توفّر مجموعة changes
طريقة فعّالة لرصد جميع تغييرات الملفات، بما في ذلك التغييرات التي تتم مشاركتها مع المستخدم. إذا تم تغيير الملف، فستوفر المجموعة
الحالة الحالية لكل ملف.
الحصول على الرمز المميز للصفحة الرئيسية
لطلب الرمز المميّز للصفحة للحالة الحالية للحساب، استخدِم
changes.getStartPageToken
.
يمكنك تخزين هذا الرمز المميّز واستخدامه في مكالمتك الأولى مع الرقم
changes.list
.
لاسترداد الرمز المميز للصفحة الحالية:
Java
Python
PHP
NET.
Node.js
إجراء التغييرات
لعرض قائمة التغييرات للمستخدم المسجّل الدخول حاليًا، أرسِل طلب GET
إلى مجموعة changes
، كما هو موضّح في
changes.list
.
يتم ترتيب الإدخالات في مجموعة changes
بترتيب زمني (تظهر التغييرات الأقدم أولاً). تحدّد مَعلمتَا طلب البحث includeRemoved
وrestrictToMyDrive
ما إذا كان الردّ يجب أن يتضمّن عناصر مُزالة أو مشتركة.
Java
Python
PHP
NET.
Node.js
قد تحتوي مجموعة changes
في
الرد على
nextPageToken
. إذا كانت السمة nextPageToken
مدرَجة، يمكن استخدامها لجمع الصفحة التالية من التغييرات. وإذا لم يكن مدرجًا، يجب أن يخزّن تطبيق العميل newStartPageToken
في استجابة التطبيق لاستخدامها في المستقبل. باستخدام الرمز المميز للصفحة الذي تم تخزينه، يتم إعداد تطبيق العميل
للاستعلام مرة أخرى عن التغييرات المستقبلية.
استلام الإشعارات
استخدِم طريقة changes.watch
للاشتراك
في التعديلات في سجلّ التغيير. لا تحتوي الإشعارات على
تفاصيل حول التغييرات. بدلاً من ذلك، تشير إلى توفر تغييرات جديدة. ولاسترداد التغييرات الفعلية، أجرِ استطلاعًا لخلاصة التغييرات كما هو موضّح في مقالة الحصول على
التغييرات.
لمزيد من المعلومات، راجِع إشعارات تغييرات الموارد.