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