Method: revisions.list

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

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

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

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