Method: revisions.list

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
pageSize

integer

हर पेज के लिए, ज़्यादा से ज़्यादा कितनी बार के बदलावों की जानकारी दिखानी है.
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

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