Method: changes.list

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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

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