באפליקציות 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
כדי להירשם לעדכונים ביומן השינויים. ההתראות לא כוללות פרטים על השינויים. במקום זאת, הם מציינים שקיימים שינויים חדשים. כדי לאחזר את השינויים בפועל, סקרו את פיד השינויים כמו שמתואר בקטע Get changes (קבלת השינויים).
אפשר לקרוא מידע נוסף במאמר התראות על שינויי משאבים.