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

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