Drive API v2 की गाइड

अगर Google Drive API के वर्शन 2 का इस्तेमाल किया जाता है, तो Google Drive API गाइड v3 में मौजूद ज़्यादातर कॉन्टेंट, v2 पर भी लागू होता है. इस सेक्शन में, वर्शन 2 के बारे में पूरी जानकारी दी गई है. यह जानकारी, वर्शन 3 की गाइड के कुछ पेजों में दी गई जानकारी से अलग है. पूरा कॉन्टेक्स्ट पाने के लिए, हर उप-सेक्शन में उससे जुड़ी गाइड के पेज का लिंक दिया गया है.

दोनों वर्शन के बीच के अंतर की पूरी सूची देखने के लिए, Drive API v2 और v3 की तुलना से जुड़ा रेफ़रंस देखें.

फ़ाइल में किए गए बदलावों को डाउनलोड और पब्लिश करना

फ़ाइल के वर्शन डाउनलोड और पब्लिश करें पेज पर, यहां दी गई जानकारी सिर्फ़ v2 के लिए है. यह v3 के लिए दिखाए गए इन सेक्शन की जगह ले लेती है:

अलग-अलग वर्शन की सूची देखना और उन्हें डाउनलोड करना

किसी फ़ाइल के बदलावों की सूची मिलने के बाद, किसी भी बदलाव का कॉन्टेंट डाउनलोड किया जा सकता है. इसके लिए, आपको फ़ाइल की []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) प्रॉपर्टी को अनुमति वाला GET अनुरोध भेजना होगा. जब बदलाव का अनुरोध किया जाता है, तब Google Drive इस यूआरएल को जनरेट करता है. यह यूआरएल कुछ समय के लिए उपलब्ध होता है. बाद में इस्तेमाल करने के लिए, इस पर भरोसा न करें.

exportLinks प्रॉपर्टी को चुनकर, बदलाव को इस्तेमाल किए जा सकने वाले किसी फ़ॉर्मैट में एक्सपोर्ट भी किया जा सकता है.

कस्टम फ़ाइल प्रॉपर्टी

कस्टम फ़ाइल प्रॉपर्टी जोड़ें पेज पर दी गई जानकारी के अलावा, यहां दी गई जानकारी सिर्फ़ v2 के लिए है:

प्रॉपर्टी को properties रिसॉर्स का इस्तेमाल करके ऐक्सेस किया जाता है.

यह एक सामान्य प्रॉपर्टी का स्ट्रक्चर है. इसका इस्तेमाल, फ़ाइल पर Drive फ़ाइल का डेटाबेस आईडी सेव करने के लिए किया जा सकता है.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

सीमाओं के बारे में ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ में properties देखें.

शेयर की गई ड्राइव की सुविधा चालू करना

शेयर की गई ड्राइव की सुविधा लागू करना पेज पर दी गई जानकारी के अलावा, वर्शन 2 के लिए इस अतिरिक्त फ़ील्ड trashedDate को बदलें.

शेयर की गई ड्राइव की सुविधा लागू करना में, शेयर की गई ड्राइव के कॉन्टेंट के साथ काम करने के लिए, इन तरीकों में supportsAllDrives=true की ज़रूरत होती है:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

changes.get और changes.list तरीकों में, शेयर की गई ड्राइव के लिए कई पैरामीटर होते हैं. पैरामीटर की सूची देखने के लिए, शेयर की गई ड्राइव पर किए गए बदलावों को ट्रैक करना सेक्शन पर जाएं.

फ़ाइलें अपलोड करें

अपलोड की गई फ़ाइल का डेटा पेज पर, इस जानकारी पर ध्यान दें. यह जानकारी सिर्फ़ v2 के लिए है:

Google Docs में इंपोर्ट किए जा सकने वाले फ़ाइल टाइप

Google Drive में कोई फ़ाइल बनाते समय, कुछ फ़ाइल टाइप को Google दस्तावेज़, Google Sheets या Google Slides दस्तावेज़ में बदला जा सकता है. files.insert convert क्वेरी पैरामीटर शामिल करें और फ़ाइल की (workspace_name) mimeType प्रॉपर्टी सेट करें. ज़्यादा जानकारी के लिए, फ़ाइल का डेटा अपलोड करना लेख पढ़ें.

फ़ाइलें, फ़ोल्डर, और ड्राइव शेयर करना

फ़ाइलें, फ़ोल्डर, और ड्राइव शेयर करें पेज पर सूचना. v3 में सिर्फ़ एक फ़ील्ड, role, उपयोगकर्ता, ग्रुप या डोमेन के लिए असरदार भूमिकाओं के बारे में बताता है. दूसरे वर्शन में, किसी अनुमति के role और additionalRoles, दोनों फ़ील्ड में यह जानकारी दिखनी चाहिए कि किसी उपयोगकर्ता, ग्रुप या डोमेन के पास किसी आइटम के लिए कौनसी भूमिकाएं हैं.

v2 के लिए खोज क्वेरी में अंतर

v2 में मौजूद title फ़ील्ड, v3 में name है. उदाहरण के लिए, फ़ाइलें और फ़ोल्डर खोजना लेख पढ़ें.

v2 में मौजूद createdDate फ़ील्ड, v3 में createdTime है. उदाहरण के लिए, शेयर की गई ड्राइव खोजना लेख पढ़ें.

v2 में मौजूद modifiedDate फ़ील्ड, v3 में modifiedTime है. v2 का lastViewedByMeDate फ़ील्ड, v3 में viewedByMeTime है. ज़्यादा जानकारी के लिए, खोज क्वेरी के शब्द और ऑपरेटर देखें.