Method: changes.list

किसी उपयोगकर्ता या शेयर की गई ड्राइव के लिए किए गए बदलावों की सूची दिखाता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
driveId

string

वह शेयर की गई ड्राइव जिससे बदलावों को वापस लाया जाएगा. अगर शेयर की गई ड्राइव के लिए बदलाव के आईडी दिए गए हैं, तो उन्हें शेयर की गई ड्राइव में दिखाया जाएगा. आइडेंटिफ़ायर के तौर पर, ड्राइव आईडी और बदलाव के आईडी, दोनों का इस्तेमाल करें.
includeCorpusRemovals

boolean

अगर अनुरोध के समय उपयोगकर्ता के पास फ़ाइल का ऐक्सेस है, तो क्या बदलावों में फ़ाइल रिसॉर्स को शामिल किया जाना चाहिए. भले ही, फ़ाइल को बदलावों की सूची से हटा दिया गया हो और इस फ़ाइल के लिए कोई और बदलाव नहीं किया गया हो.
includeDeleted

boolean

क्या उन बदलावों को शामिल करना है जिनसे पता चलता है कि आइटम को बदलावों की सूची से हटा दिया गया है. उदाहरण के लिए, मिटाकर या ऐक्सेस खोकर.
includeItemsFromAllDrives

boolean

नतीजों में, 'मेरी ड्राइव' और शेयर की गई ड्राइव, दोनों के आइटम शामिल होने चाहिए या नहीं.
includeSubscribed

boolean

यह तय करता है कि नतीजे में, 'मेरी ड्राइव' के बाहर की फ़ाइलों में किए गए बदलावों को शामिल करना है या नहीं. इस विकल्प को 'गलत है' पर सेट करने पर, फ़ाइलों में किए गए बदलावों को खोज के नतीजों में शामिल नहीं किया जाएगा. जैसे, ऐप्लिकेशन डेटा फ़ोल्डर में मौजूद फ़ाइलें या शेयर की गई वे फ़ाइलें जिन्हें 'मेरी ड्राइव' में नहीं जोड़ा गया है.
includeTeamDriveItems
(deprecated)

boolean

इस्तेमाल बंद कर दिया गया है: इसके बजाय, includeItemsFromAllDrives का इस्तेमाल करें.
maxResults

integer

बदलावों की ज़्यादा से ज़्यादा संख्या.
pageToken

string

यह टोकन, अगले पेज पर पिछली सूची के अनुरोध को जारी रखने के लिए होता है. इसे पिछले जवाब में मौजूद nextPageToken की वैल्यू पर सेट किया जाना चाहिए. इसके अलावा, इसे 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 के काेड में दिखाना 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
फ़ील्ड
items[]

object (Change)

बदलावों की सूची. अगर nextPageToken भरा गया है, तो हो सकता है कि यह सूची पूरी न हो. ऐसे में, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.
largestChangeId

string (int64 format)

बदलाव का मौजूदा सबसे बड़ा आईडी.
nextPageToken

string

बदलावों के अगले पेज के लिए पेज टोकन. अगर बदलावों की सूची के आखिर तक पहुंच गया है, तो यह विकल्प नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार कर दिया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को, नतीजों के पहले पेज से फिर से शुरू करना चाहिए.
kind

string

यह हमेशा drive#changeList होता है.
etag

string

सूची का ETag.
newStartPageToken

string

आने वाले समय में होने वाले बदलावों के लिए, शुरुआती पेज का टोकन. यह विकल्प सिर्फ़ तब दिखेगा, जब बदलावों की मौजूदा सूची खत्म हो गई हो.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक 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.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

कुछ स्कोप पर पाबंदी है. इसलिए, आपके ऐप्लिकेशन को इनका इस्तेमाल करने से पहले सुरक्षा का आकलन करना होगा. ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.