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 के काेड में दिखाना 
{
  "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.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

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