Zasób manifestu edytora

Konfiguracja zasobów używana do definiowania treści i działania dodatku do Google Workspace w edytorach. Pliki manifestu dodatków do Google Workspace muszą zawierać wszystkie komponenty oznaczone jako Wymagane, jeśli rozszerzają one edytor.

Edytujący

Konfiguracja pliku manifestu dodatku do Google Workspace dla rozszerzeń do edytora. Więcej informacji znajdziesz w artykule Rozszerzanie możliwości edytorów za pomocą dodatków do Google Workspace.

Zapis JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Pola
homepageTrigger

object (HomepageTrigger)

Ta funkcja aktywatora tworzy stronę główną dodatku w aplikacji hostującej. Zastępuje ona addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Wymagany, jeśli dodatek obejmuje działanie charakterystyczne dla bieżącego dokumentu Edytora aktywowano, gdy użytkownik autoryzuje zakres drive.file .

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Wymagany w przypadku podglądu linków. Lista aktywatorów wyświetlających podgląd linków w pliku Dokumentów, Arkuszy lub Prezentacji Google. Więcej informacji znajdziesz w artykule Wyświetlanie podglądu linków z elementami inteligentnymi.

createActionTriggers[]

object (createActionTriggers)

Wymagane do tworzenia zasobów innych firm. Lista aktywatorów umożliwiających tworzenie zasobów w usłudze innej firmy za pomocą menu @. Więcej informacji znajdziesz w artykule Tworzenie zasobów innych firm za pomocą elementów inteligentnych.

OnFileScopeGrantedTrigger

Konfiguracja aktywatora kontekstowego, która jest wywoływana, gdy okno dialogowe zakresu pliku żądania korzystające z metody CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();, a użytkownik udzieli autoryzacji zakresu drive.file.

Zapis JSON
{
  "runFunction": string
}
Pola
runFunction

string

Nazwa funkcji, która ma zostać uruchomiona po przyznaniu zakresu drive.file. Jeśli została określona, musisz zaimplementować tę funkcję, aby utworzyć i zwrócić tablicę obiektów Card do wyświetlenia w interfejsie dodatku.

LinkPreviewTriggers

Konfiguracja reguły uruchamianej, gdy użytkownik wpisze lub wklej link z usługi innej firmy lub spoza Google do pliku Dokumentów, Arkuszy lub Prezentacji.

Aby skonfigurować ten aktywator dla dodatku do Google Workspace, zapoznaj się z informacjami o wyświetlaniu podglądu linków z elementami inteligentnymi.

Zapis JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Pola
labelText

string

Wymagane. Tekst przykładowego elementu inteligentnego, który prosi użytkowników o wyświetlenie podglądu linku, np. Example: Support case. Ten tekst jest statyczny i wyświetla się, zanim użytkownik uruchomi dodatek.
localizedLabelText

map (key: string, value: string)

Opcjonalnie. Mapa: labelText do zlokalizowania na inne języki. Sformatuj język w formacie ISO 639, a kraj/region w formacie ISO 3166. Język należy rozdzielać łącznikiem -. Na przykład: en-US.

Jeśli w kluczach mapy znajduje się język użytkownika, widzi on zlokalizowaną wersję labelText.

patterns[]

object (UriPattern)

Wymagane. Tablica wzorców adresów URL, które aktywują dodatek do podglądu linków.
runFunction

string

Wymagane. Nazwa funkcji, która zostanie uruchomiona, gdy użytkownik autoryzuje zakres https://www.googleapis.com/auth/workspace.linkpreview. Jeśli została określona, musisz zaimplementować tę funkcję, aby zaakceptować obiekt zdarzenia zawierający EDITOR_NAME.matchedUrl.url jako argument i zwrócić pojedynczy obiekt Card, który wyświetla podgląd linku w interfejsie dodatku.
logoUrl

string

Opcjonalnie. Ikona wyświetlana w elemencie inteligentnym i na karcie podglądu. Jeśli dodatek zostanie pominięty, pojawi się ikona na pasku narzędzi: logoUrl.

UriPattern

Konfiguracja każdego wzorca adresu URL, który powoduje wyświetlenie podglądu linku.

Zapis JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
Pola
hostPattern

string

Wymagany dla każdego wzorca adresu URL do wyświetlenia. Domena wzorca adresu URL. Dodatek wyświetla podgląd linków zawierających tę domenę w adresie URL. Aby wyświetlić podgląd linków z określonej subdomeny, np. subdomain.example.com, uwzględnij tę subdomenę. Aby wyświetlić podgląd linków w całej domenie, jako subdomenę użyj symbolu wieloznacznego z gwiazdką (*).

Na przykład *.example.com pasuje do subdomain.example.com i another.subdomain.example.com.

pathPrefix

string

Opcjonalnie. Ścieżka, która dodaje domenę hostPattern.

Jeśli na przykład wzorzec hosta adresu URL to support.example.com, aby dopasować adresy URL do zgłoszeń hostowanych w domenie support.example.com/cases/, użyj znaku cases.

Aby dopasować wszystkie adresy URL w domenie wzorca hosta, pozostaw pole pathPrefix puste.

CreateActionTriggers

Konfiguracja reguły uruchamianej, gdy użytkownik wybierze z menu Dokumentów Google @ element menu integracji z usługą firmy zewnętrznej.

Aby skonfigurować ten aktywator dla dodatku do Google Workspace, zapoznaj się z artykułem na temat tworzenia zasobów innych firm za pomocą elementów inteligentnych.

Zapis JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Pola
id

string

Wymagane. Unikalny identyfikator do rozróżniania tego punktu rozszerzenia. Identyfikator może mieć maksymalnie 64 znaki i powinien być w formacie [a-zA-Z0-9-]+..
labelText

string

Wymagane. Tekst, który pojawia się w menu @, na przykład Create support case.
localizedLabelText

map (key: string, value: string)

Opcjonalnie. Mapa: labelText do zlokalizowania na inne języki. Sformatuj język w formacie ISO 639, a kraj/region w formacie ISO 3166. Język należy rozdzielać łącznikiem -. Na przykład: en-US.

Jeśli w kluczach mapy znajduje się język użytkownika, widzi on zlokalizowaną wersję labelText.

runFunction

string

Wymagane. Nazwa funkcji, która zostanie uruchomiona, gdy użytkownik wybierze punkt rozszerzenia z menu @. Ta funkcja powinna zwrócić kartę formularza z danymi wejściowymi umożliwiającymi utworzenie zasobu zewnętrznego.
logoUrl

string

Opcjonalnie. Ikona wyświetlana w menu @. Jeśli dodatek zostanie pominięty, pojawi się ikona na pasku narzędzi: logoUrl.