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

शेयर की गई ड्राइव, 'मेरी ड्राइव' में मौजूद अलग-अलग संगठन, शेयरिंग, और मालिकाना हक के मॉडल को फ़ॉलो करती है. अगर आपका ऐप्लिकेशन, शेयर की गई ड्राइव पर फ़ाइलें बनाएगा और उन्हें मैनेज करेगा, तो आपको अपने ऐप्लिकेशन में, 'शेयर की गई ड्राइव' के लिए सहायता लागू करनी होगी. इसे लागू करना कितना मुश्किल होगा, यह आपके ऐप्लिकेशन के फ़ंक्शन पर निर्भर करता है.

शुरू करने के लिए, आपको अपने अनुरोधों में supportsAllDrives=true क्वेरी पैरामीटर शामिल करना होगा. ऐसा तब करें, जब आपका ऐप्लिकेशन नीचे दी गई कार्रवाइयां पूरी करता हो:

डिस्क एपीआई v3

• files.get
• files.list
• files.create
• files.update
• files.copy
• files.delete
• changes.list
• changes.getStartPageToken
• permissions.list
• permissions.get
• permissions.create
• permissions.update
• permissions.delete

डिस्क एपीआई v2

• 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

supportsAllDrives=true पैरामीटर से Google Drive को पता चलता है कि आपका ऐप्लिकेशन, शेयर की गई ड्राइव में मौजूद फ़ाइलों को मैनेज करने के लिए डिज़ाइन किया गया है.

अनुमतियों को पढ़ने या उनमें बदलाव करने, बदलावों को ट्रैक करने या एक से ज़्यादा कॉर्पस में खोजने की ज़रूरत वाले ऐप्लिकेशन के लिए, शेयर की गई ड्राइव की अतिरिक्त सुविधाएं ज़रूरी होती हैं. इस दस्तावेज़ के बाकी हिस्से में, इन कामों को करने के लिए ज़रूरी अतिरिक्त बदलावों को हाइलाइट किया गया है.

शेयर की गई ड्राइव में कॉन्टेंट खोजना

शेयर की गई ड्राइव खोजने के लिए, files.list तरीके का इस्तेमाल करें. इस सेक्शन में, files.list तरीके में शेयर की गई ड्राइव से जुड़े खास फ़ील्ड शामिल होते हैं. शेयर की गई ड्राइव खोजने के लिए, फ़ाइलें और फ़ोल्डर खोजें देखें.

files.list तरीके में नीचे शेयर की गई ड्राइव के लिए खास फ़ील्ड और क्वेरी मोड शामिल हैं:

• driveId — खोजने के लिए शेयर की गई ड्राइव का आईडी.

• includeItemsFromAllDrives — शेयर की गई ड्राइव के आइटम, नतीजों में शामिल किए जाने चाहिए या नहीं. अगर यह सूची मौजूद नहीं है या 'गलत है' पर सेट है, तो शेयर की गई ड्राइव के आइटम नहीं लौटाए जाते हैं.

• corpora — वे आइटम जिनमें मौजूद फ़ाइलें (फ़ाइलें या दस्तावेज़) हैं, जिन पर क्वेरी लागू होती है. user, domain, drive, और allDrives का इस्तेमाल किया जा सकता है. बेहतर परफ़ॉर्मेंस के लिए, allDrives के लिए user या drive को प्राथमिकता दें.

• supportsAllDrives — अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. गलत होने पर, शेयर की गई ड्राइव के आइटम, जवाब में शामिल नहीं किए जाते हैं.

ये क्वेरी मोड, खास तौर पर 'शेयर की गई ड्राइव' के लिए बने हैं:

includeItemsFromAllDrives	corpora	क्वेरी वर्णन
true	user	क्वेरी फ़ाइलें जिन्हें उपयोगकर्ता ने ऐक्सेस किया है. इनमें 'शेयर की गई ड्राइव' और 'मेरी ड्राइव', दोनों की फ़ाइलें शामिल हैं.
true	drive	शेयर की गई ड्राइव में मौजूद सभी आइटम की क्वेरी करता है. अनुरोध में driveId डालना ज़रूरी है.
true	allDrives	उन फ़ाइलों को क्वेरी करता है जिन्हें उपयोगकर्ता ने ऐक्सेस किया है और उन सभी 'शेयर की गई ड्राइव' में मौजूद हैं जिनमें वह सदस्य है. ध्यान दें कि जवाब में incompleteSearch : true शामिल हो सकता है. इससे पता चलता है कि इस अनुरोध के लिए कुछ कॉर्पस में खोज नहीं की गई थी.
true	domain	ऐसी क्वेरी फ़ाइलें जिन्हें डोमेन के साथ शेयर किया जाता है. इनमें, 'शेयर की गई ड्राइव' और 'मेरी ड्राइव', दोनों की फ़ाइलें शामिल हैं.

शेयर की गई ड्राइव में बदलावों को ट्रैक करना

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

ध्यान दें: अगर पुराना Drive API v2 इस्तेमाल किया जा रहा है, तो changes.get और changes.list तरीकों में खास तौर पर, शेयर की गई ड्राइव के लिए कई पैरामीटर होते हैं.

• driveId — वह 'शेयर की गई ड्राइव' जिससे बदलाव किए जाते हैं. अगर तय किया गया हो, तो बदलाव आईडी, 'शेयर की गई ड्राइव' में होने वाले बदलावों को रेफ़र करते हैं, न कि उपयोगकर्ता को दिखाई जाने वाली फ़ाइलों में होने वाले बदलाव. शेयर की गई ड्राइव के किसी खास बदलाव के बारे में बताने के लिए, शेयर की गई ड्राइव का आईडी और बदलाव आईडी, दोनों का इस्तेमाल आइडेंटिफ़ायर के तौर पर किया जाना चाहिए.
• supportsAllDrives — अनुरोध करने वाला ऐप्लिकेशन, शेयर की गई ड्राइव के साथ काम करता है या नहीं. अगर 'गलत है' पर सेट किया जाता है, तो 'शेयर की गई ड्राइव' के आइटम नहीं दिखाए जाते. इनमें 'शेयर की गई ड्राइव' और 'शेयर की गई ड्राइव' में मौजूद फ़ाइलें भी शामिल हैं.
• includeItemsFromAllDrives — शेयर की गई ड्राइव में मौजूद फ़ाइलों या बदलावों को, बदलावों की सूची में शामिल किया जाना चाहिए या नहीं.

ये क्वेरी मोड, खास तौर पर 'शेयर की गई ड्राइव' के लिए बने हैं:

includeItemsFromAllDrives	driveId	क्वेरी वर्णन
true	नहीं	ये बदलाव, 'शेयर की गई ड्राइव' में मौजूद या उसके बाहर मौजूद फ़ाइलों में होने वाले बदलावों के साथ-साथ उन 'शेयर की गई ड्राइव' में भी होते हैं जिनका उपयोगकर्ता सदस्य है.
true	हां	शेयर की गई ड्राइव में हुए बदलाव और उसमें मौजूद आइटम में हुए बदलाव दिखते हैं.

बदलाव लॉग के व्यवहार के बारे में ज़्यादा जानकारी के लिए, बदलाव लॉग देखें.

Drive के यूज़र इंटरफ़ेस (यूआई) में, 'शेयर की गई ड्राइव' से जुड़ी सहायता पाने की सुविधा चालू करें

Drive के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, शेयर की गई ड्राइव का कॉन्टेंट ऐक्सेस करने के लिए, पक्का करें कि आपने Google API कंसोल में "शेयर की गई ड्राइव से जुड़ी सहायता" को चुना हो. ज़्यादा जानकारी के लिए, Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना देखें.

शेयर की गई ड्राइव के साथ फ़ाइल पिकर का इस्तेमाल करना

फ़ाइल पिकर की मदद से, शेयर की गई ड्राइव में आइटम चुने जा सकते हैं. फ़ाइल पिकर में, 'शेयर की गई ड्राइव' की सुविधा चालू करने और 'शेयर की गई ड्राइव' व्यू जोड़ने के बारे में जानकारी पाने के लिए, Google पिकर एपीआई देखें.

अगले चरण

शेयर की गई ड्राइव बनाने और 'शेयर की गई ड्राइव' से जुड़ी अनुमतियों को मैनेज करने में मदद पाने के लिए, शेयर की गई ड्राइव को मैनेज करना पर जाएं.