Google Workspace ऐड-ऑन, अपनी ज़रूरत के हिसाब से इंटरफ़ेस दिखाई देता है, जब उपयोगकर्ता Google Drive का इस्तेमाल कर रहा होता है. इससे आपको उपयोगकर्ता को साथ ही, काम की अतिरिक्त जानकारी दें, अपने-आप टास्क पूरे करें, और तीसरे पक्ष से संपर्क करें सिस्टम का इस्तेमाल शुरू कर दिया है.
ऐड-ऑन यूज़र इंटरफ़ेस (यूआई) ऐक्सेस करना
Google Workspace ऐड-ऑन को Google डिस्क का आइकन आइकन कॉलम पर क्लिक करें. ऐप्लिकेशन Google Workspace ऐड-ऑन ये काम कर सकता है होम पेज इंटरफ़ेस, आइटम चुनने के लिए इंटरफ़ेस या दोनों को परिभाषित करें:
- अगर कोई उपयोगकर्ता Google Drive का इस्तेमाल करते समय ऐड-ऑन आइकॉन पर क्लिक करता है,
ऐड-ऑन लागू करता है
संबंधित
drive.homepageTrigger
फ़ंक्शन का इस्तेमाल करें (अगर मौजूद है). यह फ़ंक्शन होम पेज कार्ड बनाता और दिखाता है को भी Google Drive में सेव किया जा सकता है. अगर नहींdrive.homepageTrigger
फ़ंक्शन को परिभाषित किया जाता है, तो इसके बजाय कोई जेनरिक होम पेज कार्ड दिखाया जाता है. - अगर उपयोगकर्ता Google Drive में एक या उससे ज़्यादा आइटम चुनता है और फिर ऐड-ऑन पर क्लिक करता है
आइकॉन पर क्लिक करता है या ऐड-ऑन के खुले होने पर आइटम चुनता है, तो ऐड-ऑन संबंधित फ़ाइल को लागू करता है
drive.onItemsSelectedTrigger
कॉन्टेक्स्ट के हिसाब से फ़ंक्शन (अगर मौजूद हो). यह फ़ंक्शन, ऐड-ऑन के लिए Google Drive बनाता है संदर्भ के हिसाब से "चुने गए आइटम" इंटरफ़ेस और उसे दिखाने के लिए Google Drive में वापस चला जाता है.
ऐड-ऑन Drive इंटरफ़ेस बनाना
इन सामान्य बातों का पालन करके, ऐसे इंटरफ़ेस बनाए जा सकते हैं जो Google Drive का दायरा बढ़ाते हैं चरण:
- तय करें कि आप अपने ऐड-ऑन को डिस्क-विशिष्ट बनाना चाहते हैं या नहीं होम पेज पर दिखेगा. यह भी तय करें कि आप उपयोगकर्ता को Drive में मौजूद आइटम चुनता है.
- उचित को जोड़ें
addOns.common
औरaddOns.drive
फ़ील्ड से ऐड-ऑन स्क्रिप्ट प्रोजेक्ट मेनिफ़ेस्ट, जिसमें शामिल है सभी Drive के दायरे ज़रूरी हैं. - अगर Drive का खास होम पेज दिया जा रहा है, तो
लागू करें
drive.homepageTrigger
इस इंटरफ़ेस को बनाने के लिए इसका इस्तेमाल किया जा सकता है. इस टूल का इस्तेमाल करने के लिए,common.homepageTrigger
इंटरफ़ेस में Google Workspace के कई होस्ट शामिल होते हैं. - अगर Drive में उपलब्ध आइटम को चुनने के लिए इंटरफ़ेस उपलब्ध कराया जा रहा है, तो
drive.onItemsSelectedTrigger
लागू करें प्रासंगिक ट्रिगर फ़ंक्शन का इस्तेमाल करें. चुने गए आइटम के लिए Drive के काम का इंटरफ़ेस देखें) देखें. - उपयोगकर्ता की क्वेरी का जवाब देने के लिए, संबंधित कॉलबैक फ़ंक्शन लागू करें यूज़र इंटरफ़ेस (यूआई) के इंटरैक्शन, जैसे कि बटन पर होने वाले क्लिक.
Drive के होम पेज
Google Drive पर Google Workspace ऐड-ऑन दिखाया जा सकता है
होम पेज पर.
Google Drive में अपने ऐड-ऑन का सामान्य होम पेज दिखाने के लिए, बस यह पक्का करें कि
एक addOns.drive
फ़ील्ड है
के मेनिफ़ेस्ट में मौजूद हैं.
वैकल्पिक रूप से,
drive.homepageTrigger
को ऐड-ऑन मेनिफ़ेस्ट में ज़रूर शामिल करें.
दोनों ही मामलों में, आपको अपने
ऐड-ऑन का स्क्रिप्ट प्रोजेक्ट. यह फ़ंक्शन बनाने के लिए अपने आप कॉल किया जाता है
ज़रूरत पड़ने पर Drive का होम पेज ऐक्सेस करें. आपको बनाने के लिए इस फ़ंक्शन को लागू करना होगा और
सिंगल रिटर्न करो
Card
या इसकी रेंज
Card
ऐसी चीज़ें जो होम पेज बनाती हैं. होम पेज ट्रिगर फ़ंक्शन को
इवेंट ऑब्जेक्ट
होता है, जिसमें कुछ सामान्य जानकारी होती है. जैसे क्लाइंट की
प्लैटफ़ॉर्म. इवेंट ऑब्जेक्ट डेटा का इस्तेमाल, इवेंट ऑब्जेक्ट
होम पेज पर जाएं.
चुने गए आइटम के लिए, Drive के हिसाब से इंटरफ़ेस
Google Drive, कॉन्टेक्स्ट के हिसाब से ट्रिगर की मदद से यह तय करता है कि कौनसा इंटरफ़ेस
(अगर कोई है) तब दिखाया जाएगा, जब उपयोगकर्ता Google Drive के एक या उससे ज़्यादा आइटम चुनता है. जब
ट्रिगर करता है, तो यह
drive.onItemsSelectedTrigger.runFunction
फ़ील्ड में फिर से बदलाव करें मेनिफ़ेस्ट.
Drive के लिए संदर्भ के हिसाब से आइटम चुनने का इंटरफ़ेस बनाने के लिए, आपको ये काम करने होंगे फ़ॉलो किया जा रहा है:
पक्का करें कि ऐड-ऑन के मेनिफ़ेस्ट में
https://www.googleapis.com/auth/drive.addons.metadata.readonly
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है स्कोपपक्का करें कि मेनिफ़ेस्ट में
drive.onItemsSelectedTrigger
सेक्शन में जाएं.में नाम वाला फ़ंक्शन लागू करें
drive.onItemsSelectedTrigger
फ़ील्ड में डालें. यह फ़ंक्शन किसी इवेंट ऑब्जेक्ट को तर्क के तौर पर स्वीकार करता है और आपको विज्ञापनों में से किसी एकCard
ऑब्जेक्ट या इसका कलेक्शनCard
ऑब्जेक्ट.किसी भी कार्ड की तरह, आपको इन चीज़ों के लिए इस्तेमाल किए जाने वाले किसी भी कॉलबैक फ़ंक्शन को लागू करना होगा इंटरफ़ेस के लिए विजेट की इंटरैक्टिविटी. उदाहरण के लिए, यदि आप इंटरफ़ेस में, उसकी कार्रवाई और बटन पर क्लिक करने पर चलने वाला एक लागू कॉलबैक फ़ंक्शन होता है.
इवेंट ऑब्जेक्ट
इवेंट ऑब्जेक्ट बनाया और पास किया गया
drive.homepageTrigger
तक
या drive.onItemsSelectedTrigger
उन फ़ंक्शन को कॉल करने पर फ़ंक्शन ट्रिगर होता है. ट्रिगर फ़ंक्शन इनका इस्तेमाल कर सकता है
इस इवेंट ऑब्जेक्ट में दी गई जानकारी से यह तय किया जा सकता है कि ऐड-ऑन कार्ड कैसे बनाएं
या ऐड-ऑन के व्यवहार को कंट्रोल कर सकती हैं.
इवेंट ऑब्जेक्ट के पूरे स्ट्रक्चर के बारे में इसमें बताया गया है इवेंट ऑब्जेक्ट. जब Drive, ऐड-ऑन का होस्ट ऐप्लिकेशन होता है, तो संदर्भ के हिसाब से इवेंट ऑब्जेक्ट होते हैं शामिल करें Drive इवेंट ऑब्जेक्ट फ़ील्ड में, Drive से जुड़ी क्लाइंट की खास जानकारी मौजूद होती है.
आइटम चुनने के ट्रिगर के लिए, Drive इवेंट के हिसाब से बने ऑब्जेक्ट में जानकारी शामिल होती है ट्रिगर के सक्रिय होने पर उपयोगकर्ता ने जो आइटम चुने हैं, उनके बारे में जानकारी. जब कोई उपयोगकर्ता Drive में एक से ज़्यादा आइटम चुनता है, तो उनमें से एक आइटम मुख्य हित; इस आइटम को ऐक्टिव कर्सर आइटम कहा जाता है.
नीचे दिए गए उदाहरण में,
Drive इवेंट ऑब्जेक्ट
जिसे किसी
drive.onItemsSelectedTrigger
फ़ंक्शन:
{
"commonEventObject": { ... },
"drive": {
"activeCursorItem":{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl": "https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
"selectedItems": [
{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl":"https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
...
]
},
...
}