Method: changes.list

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

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

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

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

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

पैरामीटर
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

अब सेवा में नहीं है: इसके बजाय includeItemsFromAllDrives का इस्तेमाल करें.
pageSize

integer

हर पेज पर किए जाने वाले बदलावों की ज़्यादा से ज़्यादा संख्या.
pageToken

string

अगले पेज पर सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले जवाब के 'nextPageToken' की वैल्यू या getStartPageToken से मिले जवाब पर सेट किया जाना चाहिए.
restrictToMyDrive

boolean

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

string

कॉर्पस में क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. 'drive' और 'appDataफ़ोल्डर' की वैल्यू इस्तेमाल की जा सकती है.
supportsAllDrives

boolean

अनुरोध किया गया ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं.
supportsTeamDrives
(deprecated)

boolean

अब सेवा में नहीं है: इसके बजाय supportsAllDrives का इस्तेमाल करें.
teamDriveId
(deprecated)

string

अब सेवा में नहीं है: इसके बजाय driveId का इस्तेमाल करें.
includePermissionsForView

string

इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश की गई' साइट को ऐक्सेस किया जा सकता है.
includeLabels

string

जवाब के labelInfo हिस्से में शामिल करने के लिए, लेबल के आईडी की कॉमा-सेपरेटेड लिस्ट.

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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