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

ज्यादा से ज़्यादा कितने बदलावों की जानकारी दिखानी है. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम बदलावों की जानकारी दिखाए.

अगर इसे तय नहीं किया जाता है, तो ज़्यादा से ज़्यादा 100 बदलावों की जानकारी दिखेगी.

ज़्यादा से ज़्यादा वैल्यू 1000 है. 1000 से ज़्यादा वैल्यू को 1000 में बदल दिया जाएगा.
pageToken

string

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

boolean

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

string

कॉर्पोरा में क्वेरी करने के लिए, कॉमा लगाकर अलग किए गए स्पेस की सूची. 'drive' और 'appDataFolder' को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
supportsAllDrives

boolean

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

boolean

इस्तेमाल पर रोक लगा दी गई है: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
teamDriveId
(deprecated)

string

इस्तेमाल पर रोक लगा दी गई है: इसके बजाय, driveId का इस्तेमाल करें.
includePermissionsForView

string

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

string

जवाब के labelInfo वाले हिस्से में शामिल करने के लिए, कॉमा लगाकर अलग किए गए लेबल के आईडी की सूची.

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "changes": [
    {
      object (Change)
    }
  ],
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string
}
फ़ील्ड
changes[]

object (Change)

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

string

इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय की गई स्ट्रिंग "drive#changeList".
nextPageToken

string

बदलावों के अगले पेज के लिए पेज टोकन. अगर बदलावों की सूची खत्म हो गई है, तो यह मौजूद नहीं होगा. पेज टोकन की समयसीमा खत्म नहीं होती.
newStartPageToken

string

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

अनुमति पाने के लिंक

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

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