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 Folder' में मिलेगा.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश किया गया' समर्थित है.

includeLabels

string

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

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

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

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

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

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

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

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