Drive API v2 की गाइड

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

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

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

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

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

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

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

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

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

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

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

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

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

शेयर की गई ड्राइव से जुड़ी सहायता चालू करें

शेयर की गई ड्राइव के लिए सहायता लागू करें पेज पर दी गई जानकारी के अलावा, v2 के लिए इस दूसरे फ़ील्ड 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 Docs, Google Sheets या Google Slides के दस्तावेज़ में बदला जा सकता है. फ़ाइल की files.insert convert क्वेरी पैरामीटर शामिल करें और फ़ाइल की (workspace_name) mimeType प्रॉपर्टी सेट करें. ज़्यादा जानकारी के लिए, फ़ाइल का डेटा अपलोड करें देखें.

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

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

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

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

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

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