एडिटर मेनिफ़ेस्ट रिसॉर्स

यह संसाधन कॉन्फ़िगरेशन, एडिटर्स में Google Workspace ऐड-ऑन के कॉन्टेंट और व्यवहार को तय करने के लिए इस्तेमाल किया जाता है. अगर Google Workspace के ऐड-ऑन, Editor की सुविधाओं को बढ़ाते हैं, तो उनके मेनिफ़ेस्ट में ज़रूरी है के तौर पर मार्क किए गए सभी कॉम्पोनेंट होने चाहिए.

संपादक

एडिटर एक्सटेंशन के लिए, Google Workspace ऐड-ऑन के मेनिफ़ेस्ट का कॉन्फ़िगरेशन. ज़्यादा जानकारी के लिए, Google Workspace ऐड-ऑन की मदद से, एडिटर की सुविधाओं को बढ़ाना लेख पढ़ें.

JSON के काेड में दिखाना
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
फ़ील्ड
homepageTrigger

object (HomepageTrigger)

यह ट्रिगर फ़ंक्शन, होस्ट ऐप्लिकेशन में ऐड-ऑन का होम पेज बनाता है. यह addOns.common.homepageTrigger को बदल देता है.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

अगर आपके ऐड-ऑन में मौजूदा एडिटर दस्तावेज़ से जुड़ी कोई खास सुविधा शामिल है, तो इस इवेंट को ट्रिगर करना ज़रूरी है. यह तब ट्रिगर होता है, जब उपयोगकर्ता drive.file स्कोप को अनुमति देता है.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

लिंक की झलक दिखाने के लिए ज़रूरी है. Google Docs, Sheets या Slides की फ़ाइल में लिंक की झलक देखने के लिए ट्रिगर की सूची. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

createActionTriggers[]

object (createActionTriggers)

तीसरे पक्ष का संसाधन बनाने के लिए ज़रूरी है. @ मेन्यू से तीसरे पक्ष की सेवा में संसाधन बनाने के लिए ट्रिगर की सूची. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.

OnFileScopeGrantedTrigger

यह कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाले फ़ंक्शन का कॉन्फ़िगरेशन है. यह तब ट्रिगर होता है, जब CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); का इस्तेमाल करके अनुरोध फ़ाइल स्कोप डायलॉग दिखाया जाता है और उपयोगकर्ता, drive.file को स्कोप के लिए अनुमति देता है.

JSON के काेड में दिखाना
{
  "runFunction": string
}
फ़ील्ड
runFunction

string

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

LinkPreviewTriggers

यह उस ट्रिगर के लिए कॉन्फ़िगरेशन है जो तब चालू होता है, जब कोई उपयोगकर्ता तीसरे पक्ष या Google से बाहर की किसी सेवा से लिंक को Docs, Sheets या Slides की फ़ाइल में टाइप या चिपकाता है.

Google Workspace ऐड-ऑन के लिए इस ट्रिगर को सेट अप करने के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

JSON के काेड में दिखाना
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
फ़ील्ड
labelText

string

ज़रूरी है. उदाहरण के तौर पर, स्मार्ट चिप का ऐसा टेक्स्ट जो लोगों को लिंक की झलक देखने के लिए कहता है. जैसे, Example: Support case. यह टेक्स्ट स्टैटिक होता है और उपयोगकर्ताओं को ऐड-ऑन चलाने से पहले दिखता है.
localizedLabelText

map (key: string, value: string)

ज़रूरी नहीं. labelText का मैप, जिसे अन्य भाषाओं में बदला जा सकता है. भाषा को ISO 639 फ़ॉर्मैट में और देश/इलाके को ISO 3166 फ़ॉर्मैट में लिखें. दोनों के बीच में हाइफ़न - लगाएं. उदाहरण के लिए, en-US.

अगर किसी उपयोगकर्ता की जगह-भाषा, मैप की कुंजियों में मौजूद है, तो उसे labelText का स्थानीय भाषा में अनुवाद किया गया वर्शन दिखेगा.

patterns[]

object (UriPattern)

ज़रूरी है. यूआरएल पैटर्न की एक ऐसी कैटगरी जो लिंक की झलक दिखाने के लिए ऐड-ऑन को ट्रिगर करती है.
runFunction

string

ज़रूरी है. जब उपयोगकर्ता https://www.googleapis.com/auth/workspace.linkpreview स्कोप को अनुमति देता है, तब इस फ़ंक्शन को चलाया जाता है. अगर आपने इस फ़ंक्शन को तय किया है, तो आपको इसे लागू करना होगा. यह फ़ंक्शन, EDITOR_NAME.matchedUrl.url वाला इवेंट ऑब्जेक्ट स्वीकार करता है और एक Card ऑब्जेक्ट दिखाता है. यह ऑब्जेक्ट, ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) में लिंक की झलक दिखाता है.
logoUrl

string

ज़रूरी नहीं. यह आइकॉन, स्मार्ट चिप और झलक दिखाने वाले कार्ड में दिखता है. अगर इसे शामिल नहीं किया जाता है, तो ऐड-ऑन अपने टूलबार आइकॉन, logoUrl का इस्तेमाल करता है.

UriPattern

हर उस यूआरएल पैटर्न के लिए कॉन्फ़िगरेशन जिससे लिंक की झलक दिखती है.

JSON के काेड में दिखाना
{
  "hostPattern": string,
  "pathPrefix" : string
}
फ़ील्ड
hostPattern

string

हर यूआरएल पैटर्न के लिए, इसकी झलक देखना ज़रूरी है.यह यूआरएल पैटर्न का डोमेन है. यह ऐड-ऑन, उन लिंक की झलक दिखाता है जिनके यूआरएल में यह डोमेन शामिल होता है. किसी खास सबडोमेन, जैसे कि subdomain.example.com के लिए लिंक की झलक देखने के लिए, सबडोमेन शामिल करें. पूरे डोमेन के लिंक की झलक देखने के लिए, सबडोमेन के तौर पर स्टार (*) वाले वाइल्डकार्ड वर्ण का इस्तेमाल करें.

उदाहरण के लिए, *.example.com का मिलान subdomain.example.com और another.subdomain.example.com से होता है.

pathPrefix

string

ज़रूरी नहीं. यह पाथ, hostPattern के डोमेन को जोड़ता है.

उदाहरण के लिए, अगर यूआरएल होस्ट पैटर्न support.example.com है, तो support.example.com/cases/ पर होस्ट किए गए यूआरएल से मेल खाने के लिए, cases का इस्तेमाल करें.

होस्ट पैटर्न डोमेन में मौजूद सभी यूआरएल से मैच करने के लिए, pathPrefix को खाली छोड़ दें.

CreateActionTriggers

यह उस ट्रिगर का कॉन्फ़िगरेशन है जो तब चालू होता है, जब कोई उपयोगकर्ता Google Docs के @ मेन्यू से तीसरे पक्ष के इंटिग्रेशन मेन्यू आइटम को चुनता है.

Google Workspace ऐड-ऑन के लिए इस ट्रिगर को सेट अप करने के लिए, स्मार्ट चिप की मदद से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.

JSON के काेड में दिखाना
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
फ़ील्ड
id

string

ज़रूरी है. इस एक्सटेंशन पॉइंट को अलग दिखाने के लिए यूनीक आईडी. आईडी में ज़्यादा से ज़्यादा 64 वर्ण हो सकते हैं. साथ ही, यह [a-zA-Z0-9-]+. फ़ॉर्मैट में होना चाहिए.
labelText

string

ज़रूरी है. @ मेन्यू में दिखने वाला टेक्स्ट, जैसे कि Create support case.
localizedLabelText

map (key: string, value: string)

ज़रूरी नहीं. labelText का मैप, जिसे अन्य भाषाओं में बदला जा सकता है. भाषा को ISO 639 फ़ॉर्मैट में और देश/इलाके को ISO 3166 फ़ॉर्मैट में लिखें. दोनों के बीच में हाइफ़न - लगाएं. उदाहरण के लिए, en-US.

अगर किसी उपयोगकर्ता की जगह-भाषा, मैप की कुंजियों में मौजूद है, तो उसे labelText का स्थानीय भाषा में अनुवाद किया गया वर्शन दिखेगा.

runFunction

string

ज़रूरी है. जब कोई उपयोगकर्ता @ मेन्यू से एक्सटेंशन पॉइंट चुनता है, तब इस फ़ंक्शन का नाम इस्तेमाल किया जाता है. फ़ंक्शन को एक फ़ॉर्म कार्ड दिखाना चाहिए, जिसमें तीसरे पक्ष के संसाधन को बनाने के लिए इनपुट मौजूद हों.
logoUrl

string

ज़रूरी नहीं. यह आइकॉन, @ मेन्यू में दिखता है. अगर इसे शामिल नहीं किया जाता है, तो ऐड-ऑन अपने टूलबार आइकॉन, logoUrl का इस्तेमाल करता है.