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 हिस्से में शामिल करने के लिए, लेबल के आईडी की कॉमा-सेपरेटेड लिस्ट.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

उपयोगकर्ता के लिए बदलावों की सूची.

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

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

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