Method: changes.list

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

בקשת HTTP

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

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

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

פרמטרים
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

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

string

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

גוף הבקשה

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

גוף התשובה

רשימה של שינויים במשתמש.

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

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

string

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

string

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

string

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

object (Change)

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

היקפי הרשאה

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

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