Method: revisions.list

किसी फ़ाइल के वर्शन की सूची बनाता है.

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
maxResults

integer

ज़्यादा से ज़्यादा कितने वर्शन दिखाने हैं.
pageToken

string

बदलावों के लिए पेज टोकन. नतीजों का अगला पेज पाने के लिए, इस पैरामीटर को पिछले जवाब के "nextPageToken" की वैल्यू पर सेट करें.

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "items": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string
}
फ़ील्ड
items[]

object (Revision)

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

string

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

string

यह हमेशा drive#revisionList होता है.
etag

string

सूची का ETag.

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

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

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