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

מספר השינויים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.

אם לא מציינים ערך, יוחזרו לכל היותר 100 שינויים.

הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
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

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