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

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

संपादक

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)

अगर आपके ऐड-ऑन में, मौजूदा Editor दस्तावेज़ के हिसाब से व्यवहार शामिल है, तो यह ज़रूरी है. यह तब ट्रिगर होता है, जब उपयोगकर्ता 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

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

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 का इस्तेमाल करता है.