Method: revisions.list

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

अहम जानकारी: इस तरीके से, बदलावों के इतिहास वाली फ़ाइलों के लिए, बदलावों की पूरी सूची नहीं मिलती. इनमें, अक्सर बदलाव की जाने वाली Google Docs, Sheets, और Slides की फ़ाइलें शामिल हैं. जवाब में पुराने वर्शन शामिल नहीं किए जा सकते. इसका मतलब है कि जवाब में दिखाया गया पहला वर्शन, सबसे पुराना वर्शन नहीं हो सकता. Workspace Editor के यूज़र इंटरफ़ेस में दिखने वाला बदलाव का इतिहास, एपीआई से मिली सूची की तुलना में ज़्यादा जानकारी वाला हो सकता है.

एचटीटीपी अनुरोध

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
fileId

string

फ़ाइल का आईडी.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

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

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

इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, उसे 1,000 पर सेट कर दिया जाएगा.
pageToken

string

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

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

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

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

किसी फ़ाइल के बदलावों की सूची.

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

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

object (Revision)

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

string

बदलावों के अगले पेज के लिए पेज टोकन. अगर बदलावों की सूची खत्म हो गई है, तो यह विकल्प नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार कर दिया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को, नतीजों के पहले पेज से फिर से शुरू करना चाहिए. पेज टोकन आम तौर पर कई घंटों तक मान्य होता है. हालांकि, नए आइटम जोड़ने या हटाने पर, आपको मिलने वाले नतीजे अलग-अलग हो सकते हैं.
kind

string

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

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

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

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