शेयर की गई ड्राइव, 'मेरी ड्राइव' में मौजूद अलग-अलग संगठन, शेयरिंग, और मालिकाना हक के मॉडल को फ़ॉलो करती है. अगर आपका ऐप्लिकेशन, शेयर की गई ड्राइव पर फ़ाइलें बनाएगा और उन्हें मैनेज करेगा, तो आपको अपने ऐप्लिकेशन में, 'शेयर की गई ड्राइव' के लिए सहायता लागू करनी होगी. इसे लागू करना कितना मुश्किल होगा, यह आपके ऐप्लिकेशन के फ़ंक्शन पर निर्भर करता है.
शुरू करने के लिए, आपको अपने अनुरोधों में 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
तरीके में नीचे शेयर की गई ड्राइव के लिए खास फ़ील्ड और क्वेरी मोड शामिल हैं:
driveId
— वह 'शेयर की गई ड्राइव' जिससे बदलाव किए जाते हैं. अगर तय किया गया हो, तो बदलाव आईडी, 'शेयर की गई ड्राइव' में होने वाले बदलावों को रेफ़र करते हैं, न कि उपयोगकर्ता को दिखाई जाने वाली फ़ाइलों में होने वाले बदलाव. शेयर की गई ड्राइव के किसी खास बदलाव के बारे में बताने के लिए, शेयर की गई ड्राइव का आईडी और बदलाव आईडी, दोनों का इस्तेमाल आइडेंटिफ़ायर के तौर पर किया जाना चाहिए.supportsAllDrives
— अनुरोध करने वाला ऐप्लिकेशन, शेयर की गई ड्राइव के साथ काम करता है या नहीं. अगर 'गलत है' पर सेट किया जाता है, तो 'शेयर की गई ड्राइव' के आइटम नहीं दिखाए जाते. इनमें 'शेयर की गई ड्राइव' और 'शेयर की गई ड्राइव' में मौजूद फ़ाइलें भी शामिल हैं.includeItemsFromAllDrives
— शेयर की गई ड्राइव में मौजूद फ़ाइलों या बदलावों को, बदलावों की सूची में शामिल किया जाना चाहिए या नहीं.
ये क्वेरी मोड, खास तौर पर 'शेयर की गई ड्राइव' के लिए बने हैं:
includeItemsFromAllDrives |
driveId |
क्वेरी वर्णन |
---|---|---|
true |
नहीं | ये बदलाव, 'शेयर की गई ड्राइव' में मौजूद या उसके बाहर मौजूद फ़ाइलों में होने वाले बदलावों के साथ-साथ उन 'शेयर की गई ड्राइव' में भी होते हैं जिनका उपयोगकर्ता सदस्य है. |
true |
हां | शेयर की गई ड्राइव में हुए बदलाव और उसमें मौजूद आइटम में हुए बदलाव दिखते हैं. |
बदलाव लॉग के व्यवहार के बारे में ज़्यादा जानकारी के लिए, बदलाव लॉग देखें.
Drive के यूज़र इंटरफ़ेस (यूआई) में, 'शेयर की गई ड्राइव' से जुड़ी सहायता पाने की सुविधा चालू करें
Drive के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, शेयर की गई ड्राइव का कॉन्टेंट ऐक्सेस करने के लिए, पक्का करें कि आपने Google API कंसोल में "शेयर की गई ड्राइव से जुड़ी सहायता" को चुना हो. ज़्यादा जानकारी के लिए, Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना देखें.
शेयर की गई ड्राइव के साथ फ़ाइल पिकर का इस्तेमाल करना
फ़ाइल पिकर की मदद से, शेयर की गई ड्राइव में आइटम चुने जा सकते हैं. फ़ाइल पिकर में, 'शेयर की गई ड्राइव' की सुविधा चालू करने और 'शेयर की गई ड्राइव' व्यू जोड़ने के बारे में जानकारी पाने के लिए, Google पिकर एपीआई देखें.
अगले चरण
शेयर की गई ड्राइव बनाने और 'शेयर की गई ड्राइव' से जुड़ी अनुमतियों को मैनेज करने में मदद पाने के लिए, शेयर की गई ड्राइव को मैनेज करना पर जाएं.