इस गाइड में, revisions
रिसॉर्स का इस्तेमाल करके, फ़ाइल के वर्शन मैनेज करने का तरीका बताया गया है. जैसे, फ़ाइल का वर्शन पाना और
Google Workspace में मौजूद किसी फ़ाइल का वर्शन पब्लिश करना. Google Drive API की मदद से, वर्शन डाउनलोड भी किए जा सकते हैं. वर्शन से जुड़ी शब्दावली के बारे में ज़्यादा जानने के लिए, बदलाव
और वर्शन की खास जानकारी देखें.
वर्शन का इतिहास ऐक्सेस करने के लिए, उपयोगकर्ता के पास owner, organizer, fileOrganizer या writer की role होनी चाहिए.
जवाब में दिखाए जाने वाले फ़ील्ड तय करने के लिए, fields
सिस्टम पैरामीटर
को revisions रिसोर्स के किसी भी तरीके के साथ सेट किया जा सकता है. अगर पैरामीटर शामिल नहीं किया जाता है, तो सर्वर, फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. उदाहरण के लिए, revisions.list तरीका सिर्फ़ id, mimeType, kind, और modifiedTime फ़ील्ड दिखाता है. अलग-अलग फ़ील्ड दिखाने के लिए, खास फ़ील्ड दिखाना लेख पढ़ें.
अपने-आप मिटने से बचाने के लिए, वर्शन तय करना
Google Drive, पुराने वर्शन को अपने-आप मिटा देता है. ऐसा तब होता है, जब उपयोगकर्ता को उन वर्शन की ज़रूरत नहीं होती.
एक blob फ़ाइल के वर्शन को "हमेशा के लिए रखें" पर सेट किया जा सकता है. इसका मतलब है कि वर्शन को अपने-आप नहीं मिटाया जा सकता. "हमेशा के लिए रखें" पर ज़्यादा से ज़्यादा 200 वर्शन सेट किए जा सकते हैं. इन्हें आपकी स्टोरेज लिमिट में गिना जाता है. सबसे नए वर्शन को कभी भी अपने-आप नहीं मिटाया जाता.
ब्लॉब फ़ाइल का कोई भी वर्शन मिटाया जा सकता है. हालांकि, सबसे नए वर्शन को नहीं मिटाया जा सकता. इसके अलावा, "हमेशा के लिए रखें" के तौर पर सेव किए गए वर्शन को भी नहीं मिटाया जा सकता. आम तौर पर, मिटाए जा सकने वाले वर्शन 30 दिनों तक सेव रहते हैं. हालांकि, इन्हें पहले भी मिटाया जा सकता है. ऐसा तब होता है, जब किसी फ़ाइल के 100 वर्शन "हमेशा के लिए रखें" के तौर पर सेव न किए गए हों और कोई नया वर्शन अपलोड किया गया हो.
जिन वर्शन को Drive से मिटाना नहीं है उन्हें मार्क करने के लिए, revisions रिसोर्स के बूलियन keepForever फ़ील्ड को true पर सेट करें. ब्लॉब फ़ाइल के किसी वर्शन को "हमेशा के लिए रखें" पर सेट करने के बाद, उसे सिर्फ़ डाउनलोड या मिटाया जा सकता है. ज़्यादा जानकारी के लिए, वर्शन डाउनलोड करना या वर्शन
मिटाना लेख पढ़ें.
अगर Drive API v2 का पुराना वर्शन इस्तेमाल किया जा रहा है, तो
keepForever के बजाय
revisions रिसोर्स के pinned फ़ील्ड का इस्तेमाल करें.
फ़ाइल का वर्शन पाना
फ़ाइल के किसी वर्शन का मेटाडेटा या कॉन्टेंट पाने के लिए, get तरीके का इस्तेमाल
revisions रिसॉर्स पर fileId और
revisionId पाथ पैरामीटर के साथ करें. अगर आपको वर्शन का आईडी नहीं पता है, तो किसी फ़ाइल के सभी वर्शन की सूची देखने के लिए, आप list
का इस्तेमाल कर सकते हैं list तरीके से.
यह तरीका, वर्शन के मेटाडेटा को revisions रिसोर्स के इंस्टेंस के तौर पर दिखाता है. अगर alt=media पैरामीटर दिया जाता है, तो जवाब के मुख्य हिस्से में वर्शन का कॉन्टेंट शामिल होता है. ब्लॉब फ़ाइल डाउनलोड करने के लिए, पुराने वर्शन में ब्लॉब फ़ाइल का कॉन्टेंट डाउनलोड करना लेख पढ़ें.
मालवेयर या आपत्तिजनक कॉन्टेंट वाली फ़ाइलों को डाउनलोड करने से जुड़े जोखिम के बारे में बताने के लिए, acknowledgeAbuse क्वेरी पैरामीटर को true पर सेट करें. यह फ़ील्ड सिर्फ़ तब लागू होता है, जब alt=media पैरामीटर सेट किया गया हो और उपयोगकर्ता, फ़ाइल का मालिक हो या शेयर की गई ड्राइव का कोई ऑर्गनाइज़र हो, जिसमें फ़ाइल मौजूद है.
किसी फ़ाइल के वर्शन की सूची देखना
किसी फ़ाइल के वर्शन की सूची देखने के लिए, list
तरीके का इस्तेमाल revisions रिसोर्स पर
fileId पाथ पैरामीटर के साथ करें. यह तरीका, फ़ाइल के वर्शन की सूची दिखाता है.
वर्शन को फ़िल्टर करने या उनके पेज नंबर तय करने के लिए, ये क्वेरी पैरामीटर पास करें:
pageSize: हर पेज पर दिखाए जाने वाले वर्शन की ज़्यादा से ज़्यादा संख्या.pageToken: पेज टोकन, जो सूची के पिछले कॉल से मिला हो. इसके बाद वाला पेज पाने के लिए, यह टोकन दें.
फ़ाइल का वर्शन अपडेट करना
किसी फ़ाइल के वर्शन को अपडेट करने के लिए, update तरीके का इस्तेमाल revisions रिसोर्स पर fileId और revisionId पाथ
पैरामीटर के साथ करें.
यह तरीका, revisions रिसोर्स का एक इंस्टेंस दिखाता है.
वर्शन डाउनलोड करना
सिर्फ़ ब्लॉब फ़ाइल के उन वर्शन को डाउनलोड किया जा सकता है जिन्हें "हमेशा के लिए रखें" के तौर पर सेव किया गया है. अगर आपको कोई वर्शन डाउनलोड करना है, तो पहले उसे "हमेशा के लिए रखें" पर सेट करें. ज़्यादा जानकारी के लिए, अपने-आप मिटने से बचाने के लिए, वर्शन तय करना लेख पढ़ें.
ब्लॉब फ़ाइल के किसी वर्शन को डाउनलोड करने या Google Workspace के किसी दस्तावेज़ के वर्शन को एक्सपोर्ट करने के लिए, फ़ाइलें डाउनलोड और एक्सपोर्ट करना लेख पढ़ें.
फ़ाइल का वर्शन मिटाना
फ़ाइल के किसी वर्शन को हमेशा के लिए मिटाने के लिए, delete तरीके का इस्तेमाल revisions रिसोर्स पर fileId और revisionId पाथ
पैरामीटर के साथ करें.
Drive में, सिर्फ़ ब्लॉब फ़ाइलों के वर्शन मिटाए जा सकते हैं. इनमें बाइनरी कॉन्टेंट होता है. जैसे, इमेज, वीडियो, और PDF. ब्लॉब फ़ाइल के किसी वर्शन को तब मिटाया जा सकता है, जब उसे "हमेशा के लिए रखें" के तौर पर सेव किया गया हो. अन्य फ़ाइलों के वर्शन नहीं मिटाए जा सकते. जैसे, Google Docs या Sheets की फ़ाइलें. इसके अलावा, बाइनरी फ़ाइल का आखिरी वर्शन भी नहीं मिटाया जा सकता.
वर्शन पब्लिश करना
Google Docs, Google Sheets, और Google Slides के किसी वर्शन को पब्लिश करने के लिए, उस फ़ाइल के लिए published प्रॉपर्टी को
revisions रिसोर्स में सेट करें. Drive API का इस्तेमाल करके, Google Sites के वर्शन के लिए यह प्रॉपर्टी सेट नहीं की जा सकती.
पब्लिश किए गए वर्शन में, फ़ाइल में किए गए बदलाव तब तक नहीं दिखते, जब तक publishAuto प्रॉपर्टी सेट न की गई हो. अगर प्रॉपर्टी को true पर सेट किया जाता है, तो किसी फ़ाइल के नए वर्शन अपने-आप पब्लिश हो जाते हैं. इससे पुराने वर्शन मिट जाते हैं.
Slides और Drawings में, सिर्फ़ अपने-आप फिर से पब्लिश करने की सुविधा काम करती है. इसके लिए, publishAuto प्रॉपर्टी को true पर सेट करना ज़रूरी है. Sites की फ़ाइलों के लिए, publishAuto हमेशा false होता है.
अगर फ़ाइल, Google Workspace डोमेन में बनाई गई है, तो publishedOutsideDomain प्रॉपर्टी से पता चलता है कि वर्शन को कोई भी ऐक्सेस कर सकता है या यह सिर्फ़ डोमेन के उपयोगकर्ताओं के लिए उपलब्ध है. Sites की फ़ाइलों के लिए, इस प्रॉपर्टी से पता चलता है कि type=anyone की अनुमति मौजूद है या नहीं. ज़्यादा जानकारी के लिए, permissions रिसोर्स पर
type फ़ील्ड देखें.
Docs और Sheets के यूज़र इंटरफ़ेस (यूआई) में, "बदलाव हो जाने पर अपने-आप फिर से पब्लिश करें" चेकबॉक्स से भी, अपने-आप पब्लिश होने की सुविधा को कंट्रोल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Docs, Sheets, Slides और Forms की फ़ाइल को वेब पर सभी लोगों के लिए उपलब्ध कराना लेख पढ़ें.