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

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

संपादक

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

जेएसओएन के काेड में दिखाना
  {
    "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 स्कोप की अनुमति देने पर ट्रिगर होता है.

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

string

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

LinkPreviewTriggers

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

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

जेएसओएन के काेड में दिखाना
{
  "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

हर यूआरएल पैटर्न का कॉन्फ़िगरेशन, जो लिंक की झलक को ट्रिगर करता है.

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए इस ट्रिगर को सेट अप करना है, तो स्मार्ट चिप की मदद से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.

जेएसओएन के काेड में दिखाना
{
  "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 का इस्तेमाल करता है.