Method: changes.list

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
driveId

string

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

boolean

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

boolean

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

boolean

אם הפריטים 'האחסון שלי' וגם פריטים באחסון השיתופי צריכים להיכלל בתוצאות.
includeSubscribed

boolean

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

boolean

הוצאה משימוש: יש להשתמש במקום זאת ב-includeItemsFromAllDrives.
maxResults

integer

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

string

האסימון להמשך בקשה קודמת לרשימה בדף הבא. יש להגדיר את הערך הזה לערך nextPageToken מהתגובה הקודמת או לתגובה מ-method 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 
{
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Change)
    }
  ]
}
שדות
largestChangeId

string (int64 format)

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

string

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

string

הערך הוא תמיד drive#changeList.
etag

string

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

string

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

object (Change)

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

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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