يسرد التغييرات لمستخدم أو مساحة تخزين سحابي مشتركة.
طلب HTTP
GET https://www.googleapis.com/drive/v2/changes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
driveId |
مساحة التخزين السحابي المشتركة التي سيتم عرض التغييرات منها. في حال تحديد أرقام تعريف التغييرات التي ستعكس مساحة التخزين السحابي المشتركة، استخدِم رقم تعريف مساحة التخزين السحابي المشترَكة ورقم تعريف التغيير كمعرِّف. |
includeCorpusRemovals |
ما إذا كان يجب أن تتضمن التغييرات مورد الملف إذا كان المستخدم لا يزال بإمكانه الوصول إلى الملف في وقت الطلب، حتى بعد إزالة الملف من قائمة التغييرات ولن تكون هناك أي إدخالات أخرى لتغيير هذا الملف. |
includeDeleted |
لتحديد ما إذا كان سيتم تضمين تغييرات تشير إلى إزالة عناصر من قائمة التغييرات، على سبيل المثال عن طريق الحذف أو فقدان الوصول. |
includeItemsFromAllDrives |
يمكنك اختيار ما إذا كان يجب تضمين كل من "ملفاتي" والعناصر في مساحة التخزين السحابي المشتركة في النتائج. |
includeSubscribed |
يمكنك اختيار ما إذا كنت تريد تضمين تغييرات خارج التدرّج الهرمي "ملفاتي" في النتيجة. أمّا في حال ضبطها على "خطأ"، فسيتم حذف التغييرات على الملفات، مثل تلك الواردة في مجلد "بيانات التطبيق" أو الملفات المشتركة التي لم تتم إضافتها إلى "ملفاتي"، من النتيجة. |
includeTeamDriveItems |
متوقّفة نهائيًا: يمكنك استخدام |
maxResults |
الحد الأقصى لعدد التغييرات المطلوب عرضها. |
pageToken |
الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية يجب ضبط ذلك على قيمة |
spaces |
قائمة مفصولة بفواصل تحتوي على المسافات للاستعلام عنها. والقيمتان المسموح بإدراجهما هما |
startChangeId |
متوقّفة نهائيًا: يمكنك استخدام |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
متوقّفة نهائيًا: يمكنك استخدام |
teamDriveId |
متوقّفة نهائيًا: يمكنك استخدام |
includePermissionsForView |
تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يُسمح فقط بالقيمة |
includeLabels |
قائمة مفصولة بفواصل تضم معرّفات التصنيفات المراد تضمينها في الجزء |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة التغييرات لأحد المستخدمين.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
الحقول | |
---|---|
largestChangeId |
رقم تعريف التغيير الأكبر الحالي |
nextPageToken |
الرمز المميز للصفحة للصفحة التالية من التغييرات. لن يكون هذا الخيار متاحًا في حال الوصول إلى نهاية قائمة التغييرات. وإذا تم رفض الرمز المميز لأي سبب من الأسباب، يجب تجاهله وإعادة تشغيل التقسيم على صفحات من الصفحة الأولى من النتائج. |
kind |
دائمًا ما تكون |
etag |
علامة ETag للقائمة. |
newStartPageToken |
الرمز المميّز لصفحة البداية من أجل التغييرات المستقبلية. لن تظهر هذه التغييرات إلا إذا تم الوصول إلى نهاية قائمة التغييرات الحالية. |
selfLink |
رابط للرجوع إلى هذه القائمة. |
nextLink |
رابط إلى الصفحة التالية من التغييرات. |
items[] |
قائمة التغييرات. في حال تعبئة 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.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.