Method: changes.list

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

בקשת HTTP

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

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

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

פרמטרים
driveId

string

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

boolean

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

boolean

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

boolean

האם לכלול שינויים שמציינים שהפריטים הוסרו מרשימת השינויים, למשל בגלל מחיקה או אובדן גישה.
includeTeamDriveItems
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ב-includeItemsFromAllDrives.
pageSize

integer

המספר המקסימלי של שינויים שיוחזרו בכל דף.
pageToken

string

האסימון להמשך בקשה קודמת של רשימה בדף הבא. הערך הזה צריך להיות הערך של nextPageToken מהתשובה הקודמת או מהתשובה של השיטה getStartPageToken.
restrictToMyDrive

boolean

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

string

רשימה מופרדת בפסיקים של מרחבים לשאילתה בתוך מאגרי המידע. הערכים הנתמכים הם drive ו-appDataFolder.
supportsAllDrives

boolean

האם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
teamDriveId
(deprecated)

string

הוצא משימוש: במקומו צריך להשתמש ב-driveId.
includePermissionsForView

string

מציין אילו הרשאות של תצוגות נוספות לכלול בתשובה. רק הערך 'published' נתמך.
includeLabels

string

רשימה מופרדת בפסיקים של מזהי התוויות שרוצים לכלול בחלק labelInfo של התשובה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

רשימת שינויים שבוצעו עבור משתמש.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "changes": [
    {
      object (Change)
    }
  ],
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string
}
שדות
changes[]

object (Change)

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

string

מזהה את סוג המשאב. הערך: המחרוזת הקבועה "drive#changeList".
nextPageToken

string

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

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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

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