編輯器資訊清單資源

用來定義下列項目的資源設定 Google Workspace 外掛程式 編輯器中的內容和行為 Google Workspace 外掛程式資訊清單必須具備 只要是擴充編輯器,標示為「必要」的元件。

編輯器

應用程式的 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 文件、試算表或簡報檔案中的連結。 詳情請參閱「使用智慧型方塊預覽連結」。

createActionTriggers[]

object (createActionTriggers)

建立第三方資源時必填。透過 @ 選單在第三方服務中建立資源的觸發條件清單。 詳情請參閱「使用智慧型方塊建立第三方資源」。

OnFileScopeGrantedTrigger

內容相關觸發條件的設定,會在 使用 CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); 要求檔案範圍對話方塊,且使用者授予 drive.file 範圍授權。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

drive.file 範圍是時要執行的函式名稱 。如有指定,您必須實作這個函式來建構 傳回 的陣列 Card 物件,顯示在外掛程式 UI 中。

LinkPreviewTriggers

觸發條件設定會在使用者輸入或貼上連結時觸發 將第三方或非 Google 服務的資料匯出到 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 物件,在外掛程式 UI 中顯示連結預覽。
logoUrl

string

選用設定。智慧型方塊和預覽資訊卡中的圖示。如果 省略後,外掛程式會使用工具列圖示 logoUrl

UriPattern

每個會觸發連結預覽的網址模式設定。

JSON 表示法
{
  "hostPattern": string,
  "pathPrefix" : string
}
欄位
hostPattern

string

每個要預覽的網址格式的必填屬性。網址模式的網域。外掛程式預覽連結的網址會包含該網域。如要預覽特定子網域 (例如 subdomain.example.com) 的連結,請加入子網域。 如要預覽整個網域的連結,請指定萬用字元並以星號 (*) 做為子網域。

舉例來說,*.example.com 符合 subdomain.example.comanother.subdomain.example.com

pathPrefix

string

選用設定。附加 hostPattern 網域的路徑。

舉例來說,如果網址主機模式是 support.example.com,如要比對由 support.example.com/cases/ 代管的案件網址,請使用 cases

如要比對主機模式網域中的所有網址,請將 pathPrefix 留空。

CreateActionTriggers

使用者選取第三方時觸發的觸發條件設定 Google 文件 @ 選單中的整合選單項目。

如要為 Google Workspace 外掛程式設定這項觸發條件, 看 使用智慧型方塊建立第三方資源

JSON 表示法
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
欄位
id

string

必要。用於區分這項額外資訊的專屬 ID 點。ID 的長度上限為 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