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

Google Workspace ऐड-ऑन, अपनी ज़रूरत के हिसाब से इंटरफ़ेस, जब उपयोगकर्ता Google Drive का इस्तेमाल कर रहा होता है. इससे, उपयोगकर्ता को ज़्यादा काम की जानकारी दी जा सकती है, टास्क अपने-आप होने की सुविधा चालू की जा सकती है, और तीसरे पक्ष के सिस्टम को 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 फ़ंक्शन लागू करें. इस टूल का इस्तेमाल करने के लिए, common.homepageTrigger इंटरफ़ेस में Google Workspace के कई होस्ट शामिल होते हैं.
  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"
          },
          ...
        ]
      },
      ...
    }