Zasób manifestu edytora

Konfiguracja zasobu, która służy 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ą Edytor.

Edytujący

Konfiguracja pliku manifestu dodatku do Google Workspace dla rozszerzeń edytora. Więcej informacji znajdziesz w artykule Rozszerzanie Edytorów za pomocą dodatków Google Workspace.

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

object (HomepageTrigger)

Ta funkcja wywołująca tworzy stronę główną dodatku w aplikacji hosta. Zastępuje ona addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Wymagany, jeśli dodatek zawiera zachowanie specyficzne dla bieżącego dokumentu Edytora, które jest wywoływane, gdy użytkownik autoryzuje zakres drive.file .
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Wymagane w przypadku podglądu linków. Lista wyzwalaczy podglądu linków w pliku Dokumentów, Arkuszy lub Prezentacji Google. Więcej informacji znajdziesz w artykule Wyświetlanie podglądu linku za pomocą elementów inteligentnych.
createActionTriggers[]

object (createActionTriggers)

Wymagane do utworzenia zasobu innej firmy. Lista aktywatorów do tworzenia zasobów w usłudze innej firmy z menu @. Więcej informacji znajdziesz w artykule Tworzenie zasobów innych firm za pomocą elementów inteligentnych.

OnFileScopeGrantedTrigger

Konfiguracja aktywatora kontekstowego, który uruchamia się, gdy użytkownik wyświetli okno dialogowe zakresu pliku żądania za pomocą CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); i przyzna autoryzację zakresu drive.file.

Zapis JSON 
{
  "runFunction": string
}
Pola
runFunction

string

Nazwa funkcji, która ma zostać uruchomiona, jeśli przyznano drive.file zakres. Jeśli ta funkcja jest określona, musisz ją wdrożyć, aby utworzyć i zwrócić tablicę obiektów Card do wyświetlania w interfejsie dodatku.

LinkPreviewTriggers

Konfiguracja wyzwalacza, który uruchamia się, gdy użytkownik wpisze lub wklei link z usługi innej firmy lub usługi Google do pliku Dokumentów, Arkuszy lub Prezentacji.

Aby skonfigurować ten wyzwalacz w dodatku do Google Workspace, zapoznaj się z artykułem Wyświetlanie podglądu linku za pomocą elementów inteligentnych.

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 zachęca użytkowników do wyświetlenia podglądu linku, np. Example: Support case. Ten tekst jest statyczny i wyświetla się, zanim użytkownicy uruchomią dodatek.
localizedLabelText

map (key: string, value: string)

Opcjonalnie: Mapa labelText do lokalizowania na inne języki. Podaj język w formacie ISO 639, a kraj lub region w formacie ISO 3166, oddzielając je myślnikiem -. Na przykład: en-US.

Jeśli język użytkownika jest obecny w kluczach mapy, zobaczy on zlokalizowaną wersję labelText.
patterns[]

object (UriPattern)

Wymagane. Tablica wzorców adresów URL, które powodują wyświetlanie podglądu linków przez dodatek.
runFunction

string

Wymagane. Nazwa funkcji, która ma być uruchamiana, gdy użytkownik autoryzuje zakres https://www.googleapis.com/auth/workspace.linkpreview. Jeśli ta funkcja jest określona, musisz ją wdrożyć, aby akceptowała obiekt zdarzenia zawierający EDITOR_NAME.matchedUrl.url jako argument i zwracała pojedynczy obiekt Card, który wyświetla podgląd linku w interfejsie dodatku.
logoUrl

string

Opcjonalnie: Ikona wyświetlana w inteligentnym tagu i na karcie podglądu. Jeśli ten parametr zostanie pominięty, dodatek użyje ikony paska narzędzi logoUrl.

UriPattern

Konfiguracja każdego wzorca adresu URL, który wywołuje podgląd linku.

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

string

Wymagane w przypadku każdego wzorca adresu URL, aby wyświetlić podgląd. Domena wzorca adresu URL. Dodatek wyświetla podgląd linków, które zawierają tę domenę w adresie URL. Aby wyświetlić podgląd linków do konkretnej subdomeny, np. subdomain.example.com, uwzględnij ją. Aby wyświetlić podgląd linków do całej domeny, jako subdomenę podaj symbol wieloznaczny w postaci gwiazdki (*).

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

string

Opcjonalnie: Ścieżka, która dołącza domenę hostPattern.

Jeśli np. wzorzec hosta adresu URL to support.example.com, aby dopasować adresy URL w przypadku hostów w domenie support.example.com/cases/, użyj wzorca cases.

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

CreateActionTriggers

Konfiguracja reguły, która jest uruchamiana, gdy użytkownik wybierze element menu integracji innej firmy z menu @ w Dokumentach Google.

Aby skonfigurować ten wyzwalacz dla dodatku Google Workspace, zapoznaj się z artykułem Tworzenie zasobów innych firm za pomocą inteligentnych elementów.

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

string

Wymagane. Unikalny identyfikator odróżniający ten punkt rozszerzenia. Identyfikator może mieć maksymalnie 64 znaki i powinien mieć format [a-zA-Z0-9-]+..
labelText

string

Wymagane. Tekst, który pojawia się w menu @, np. Create support case.
localizedLabelText

map (key: string, value: string)

Opcjonalnie: Mapa labelText do lokalizowania na inne języki. Podaj język w formacie ISO 639, a kraj lub region w formacie ISO 3166, oddzielając je myślnikiem -. Na przykład: en-US.

Jeśli język użytkownika jest obecny w kluczach mapy, zobaczy on zlokalizowaną wersję labelText.
runFunction

string

Wymagane. Nazwa funkcji, która ma być uruchamiana, gdy użytkownik wybierze punkt rozszerzenia z menu @. Funkcja powinna zwracać kartę formularza z polami do tworzenia zasobu zewnętrznego.
logoUrl

string

Opcjonalnie: Ikona wyświetlana w menu @. Jeśli ten parametr zostanie pominięty, dodatek użyje ikony paska narzędzi logoUrl.