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