Method: changes.list

בתיבת הדו שיח הזו רשומים השינויים שבוצעו על ידי משתמש או אחסון שיתופי.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של שאילתה

פרמטרים
driveId

string

האחסון השיתופי שממנו יוחזרו השינויים. אם צוין, מזהי השינויים ישקפו את האחסון השיתופי. להשתמש במזהה האחסון המשולב ולשנות את המזהה בתור מזהה.

includeCorpusRemovals

boolean

האם השינויים צריכים לכלול את משאב הקובץ אם הקובץ עדיין זמין למשתמש בזמן הבקשה, גם אם קובץ הוסר מרשימת השינויים ולא יהיו רשומות שינויים נוספות בקובץ הזה.

includeDeleted

boolean

האם לכלול שינויים שמעידים על כך שפריטים הוסרו מרשימת השינויים, לדוגמה מחיקה או אובדן גישה.

includeItemsFromAllDrives

boolean

אם צריך לכלול בתוצאות גם פריטים בתיקייה 'האחסון שלי' וגם פריטים באחסון השיתופי.

includeSubscribed

boolean

האם לכלול בתוצאה שינויים מחוץ להיררכיה של 'האחסון שלי'. אם המדיניות מוגדרת כ-False, שינויים בקבצים כמו אלה שבתיקייה 'נתוני אפליקציות' או קבצים משותפים שלא נוספו אל 'האחסון שלי' יוסרו מהתוצאה.

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
{
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Change)
    }
  ]
}
שדות
largestChangeId

string (int64 format)

מזהה השינוי הגדול ביותר הנוכחי.

nextPageToken

string

אסימון הדף של דף השינויים הבא. השדה הזה לא יופיע אם הרשימה של השינויים תסתיים. אם האסימון נדחה מסיבה כלשהי, צריך למחוק אותו ולהתחיל מחדש את העימוד מהדף הראשון של התוצאות.

kind

string

הערך הוא תמיד drive#changeList.

etag

string

ה-ETag של הרשימה.

newStartPageToken

string

אסימון דף הפתיחה לשינויים עתידיים. יוצג רק אם רשימת השינויים הנוכחית מסתיימת.

items[]

object (Change)

רשימת השינויים. אם 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.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

חלק מההיקפים מוגבלים וצריך לבצע בדיקת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך להרשאות.