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

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

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

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

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

ऐड-ऑन 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 के हिसाब से होम पेज उपलब्ध कराने के लिए, ऐड-ऑन मेनिफ़ेस्ट में drive.homepageTrigger जोड़ें.

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

चुने गए आइटम के लिए, Drive का काम का इंटरफ़ेस

जब उपयोगकर्ता एक या एक से ज़्यादा Google Drive आइटम चुनता है, तो Google Drive, कौनसा इंटरफ़ेस (अगर कोई है) दिखाने के लिए, कॉन्टेक्स्ट के हिसाब से ट्रिगर की मदद लेता है. ट्रिगर ट्रिगर होने पर, यह ऐड-ऑन मेनिफ़ेस्ट के 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"
          },
          ...
        ]
      },
      ...
    }