Google Drive के इंटरफ़ेस बनाना

Google Workspace जब उपयोगकर्ता Google डिस्क का उपयोग कर रहा हो, तो ऐड-ऑन कस्टमाइज़ किए गए इंटरफ़ेस दे सकते हैं. इससे आप उपयोगकर्ताओं को अतिरिक्त काम की जानकारी दे सकते हैं, टास्क अपने-आप पूरे कर सकते हैं, और तीसरे पक्ष के सिस्टम को Google Drive से जोड़ सकते हैं.

ऐड-ऑन यूज़र इंटरफ़ेस (यूआई) ऐक्सेस करना

अगर आपके Drive का आइकॉन, Drive के यूज़र इंटरफ़ेस की दाईं ओर मौजूद आइकॉन कॉलम में दिखता है, तो Google Drive में Google Workspace ऐड-ऑन को खोला जा सकता है. Google Workspace ऐड-ऑन, होम पेज के इंटरफ़ेस, आइटम चुनने के इंटरफ़ेस या दोनों को परिभाषित कर सकता है:

  • अगर कोई उपयोगकर्ता, Google Drive में ऐड-ऑन आइकॉन पर क्लिक करता है, तो ऐड-ऑन उससे जुड़े drive.homepageTrigger फ़ंक्शन (अगर मौजूद हो) लागू करता है. यह फ़ंक्शन दिखाने के लिए Google Drive में एक होम पेज कार्ड बनाता और दिखाता है. अगर कोई drive.homepageTrigger फ़ंक्शन तय नहीं किया गया है, तो एक सामान्य होम पेज कार्ड दिखेगा.
  • अगर उपयोगकर्ता Drive में एक या उससे ज़्यादा आइटम चुनता है और ऐड-ऑन आइकॉन पर क्लिक करता है या ऐड-ऑन चालू होने पर आइटम चुनता है, तो ऐड-ऑन, संबंधित आइटम drive.onItemsSelectedTrigger (अगर मौजूद हो) की कार्रवाई करता है. यह फ़ंक्शन ऐड-ऑन's डिस्क संदर्भ और कोट; इंटरफ़ेस बनाता है और उसे दिखाने के लिए Google Drive पर वापस ले जाता है.

ऐड-ऑन 'डिस्क' इंटरफ़ेस बनाना

आप इन सामान्य तरीकों को अपनाकर Google Drive को बढ़ाने वाले इंटरफ़ेस बना सकते हैं:

  1. यह तय करें कि आपके ऐड-ऑन में Drive के लिए खास होम पेज है या नहीं. साथ ही, यह भी तय करें कि जब उपयोगकर्ता Drive आइटम चुन रहा हो, तब क्या आपको संदर्भ से जुड़ा इंटरफ़ेस उपलब्ध कराना है.
  2. ऐड-ऑन स्क्रिप्ट प्रोजेक्ट में, ज़रूरत के हिसाब से addOns.common औरaddOns.drive फ़ील्ड जोड़ें. मैन्युअल के साथ-साथ Drive के दायरे की भी ज़रूरत होती है.
  3. अगर आप Drive के लिए खास होम पेज दे रहे हैं, तो यह इंटरफ़ेस बनाने के लिए drive.homepageTrigger फ़ंक्शन लागू करें. आप एक से ज़्यादा Google Workspace होस्ट के लिए,common.homepageTrigger इंटरफ़ेस इस्तेमाल करने का विकल्प भी चुन सकते हैं.
  4. अगर आप Drive के हिसाब से आइटम चुनने का इंटरफ़ेस दे रहे हैं, तो इस इंटरफ़ेस को बनाने के लिए, आपको drive.onItemsSelectedTrigger संदर्भ ट्रिगर फ़ंक्शन लागू करना होगा. ज़्यादा जानकारी के लिए, चुने गए आइटम के लिए Drive का इंटरफ़ेस देखें देखें.
  5. इससे जुड़े कॉलबैक फ़ंक्शन लागू करें, ताकि उपयोगकर्ता के यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन, जैसे बटन पर होने वाले क्लिक का जवाब दिया जा सके.

Drive के होम पेज

Google Drive Google Workspace ऐड-ऑन होम पेज दिखाने की सुविधा देता है. Google Drive में अपना ऐड-ऑन और आम तौर पर दिखने वाला होम पेज दिखाने के लिए, पक्का करें कि ऐड-ऑन के मेनिफ़ेस्ट में addOns.drive फ़ील्ड हो.

इसके अलावा, ऐड-ऑन मेनिफ़ेस्ट में drive.homepageTrigger जोड़ें, ताकि Drive के लिए खास होम पेज दिया जा सके.

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

चुने गए आइटम के लिए डिस्क प्रासंगिक इंटरफ़ेस

जब उपयोगकर्ता एक या ज़्यादा डिस्क आइटम चुनता है, तब Google डिस्क उसे दिखाए जाने वाले इंटरफ़ेस (अगर कोई हो) को तय करने के लिए प्रासंगिक ट्रिगर पर निर्भर करता है. जब ट्रिगर ट्रिगर होता है, तो यह ऐड-ऑन मेनिफ़ेस्ट में drive.onItemsSelectedTrigger.runFunction फ़ील्ड के ज़रिए तय किए गए संदर्भ ट्रिगर फ़ंक्शन को लागू करता है.

Drive के लिए संदर्भ के हिसाब से आइटम चुनने का इंटरफ़ेस बनाने के लिए, आपको ये काम करने होंगे:

  1. पक्का करें कि ऐड-ऑन के मेनिफ़ेस्ट में https://www.googleapis.com/auth/drive.addons.metadata.readonly दायरा शामिल है

  2. पक्का करें कि मेनिफ़ेस्ट में drive.onItemsSelectedTrigger सेक्शन शामिल हो.

  3. drive.onItemsSelectedTrigger फ़ील्ड में दिए गए फ़ंक्शन को लागू करें. यह फ़ंक्शन आर्ग्युमेंट के तौर पर इवेंट ऑब्जेक्ट स्वीकार करता है और ऑब्जेक्ट की Card ऑब्जेक्ट या Card ऑब्जेक्ट की श्रेणी दिखाता है.

  4. किसी भी कार्ड की तरह ही, आपको किसी भी कॉलबैक फ़ंक्शन को लागू करना होगा. इसका इस्तेमाल इंटरफ़ेस के लिए विजेट इंटरैक्टिविटी को देने के लिए किया जाता है. उदाहरण के लिए, अगर आप इंटरफ़ेस में कोई बटन शामिल करते हैं, तो उसमें एक अटैच की गई कार्रवाई और एक लागू किया गया कॉलबैक फ़ंक्शन होना चाहिए, जो बटन पर क्लिक होने पर चलता हो.

इवेंट ऑब्जेक्ट

इवेंट ऑब्जेक्ट बनाया और 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"
          },
          ...
        ]
      },
      ...
    }