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

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