इस गाइड में, 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 अनुमति मौजूद है या नहीं. ज़्यादा जानकारी के लिए, type फ़ील्ड को
permissions रिसॉर्स पर देखें.
पब्लिश करने की सुविधा को, Docs और Sheets के यूज़र इंटरफ़ेस (यूआई) में मौजूद "बदलाव हो जाने पर अपने-आप फिर से पब्लिश करें" चेकबॉक्स से भी कंट्रोल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Docs, Sheets, Slides और Forms की फ़ाइल को वेब पर सभी लोगों के लिए उपलब्ध कराना लेख पढ़ें.