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