Method: changes.list

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

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

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

object (Change)

רשימת השינויים. אם השדה nextPageToken מאוכלס, יכול להיות שהרשימה הזו לא מלאה וצריך לאחזר דף נוסף של תוצאות.
largestChangeId

string (int64 format)

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

string

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

string

הנתיב הזה תמיד drive#changeList.
etag

string

תג ה-ETag של הרשימה.
newStartPageToken

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של 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

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