Drive API v2 की गाइड

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

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

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

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

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

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

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

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

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

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

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

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

Search Ads 360 के वर्शन 2 में, खोज क्वेरी के अंतर

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

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

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