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

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

string

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

boolean

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

boolean

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

string

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

string

इससे यह तय होता है कि जवाब में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'published' का इस्तेमाल किया जा सकता है.
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

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