Zasób manifestu edytora

Konfiguracja zasobów używana do definiowania Dodatek do Google Workspace treści i zachowania w edytorach. Pliki manifestu dodatków do Google Workspace muszą mieć wszystkich komponentów oznaczonych jako Wymagane, jeśli rozszerzają one Edytor.

Edytujący

Konfiguracja pliku manifestu dodatku do Google Workspace dla organizacji Rozszerzenia edytora. Zobacz 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 dodatek stronie głównej w aplikację hostującą. To zastępuje addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Wymagany, jeśli dodatek działa w sposób charakterystyczny dla bieżącego Dokument edytora, aktywowany, gdy użytkownik autoryzuje zakres drive.file .
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Wymagany w przypadku podglądu linków. Lista aktywatorów dla wyświetlanie podglądu 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 uruchamiana, gdy okno żądania zakresu plików za pomocą interfejsu CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();, a użytkownik przyznaje drive.file autoryzacji zakresu.

Zapis JSON 
{
  "runFunction": string
}
Pola
runFunction

string

Nazwa funkcji do uruchomienia, jeśli zakres drive.file to przyznane. Jeśli ta funkcja jest określona, musisz ją zaimplementować, aby skompilować zwraca tablicę Card obiektów do wyświetlenia w interfejsie dodatku.

LinkPreviewTriggers

Konfiguracja reguły, która uruchamia się, gdy użytkownik wpisze lub wklej link z usługi innej firmy lub usługi innej firmy do Dokumentów Plik Arkuszy lub Prezentacji.

Aby skonfigurować ten aktywator dla dodatku do Google Workspace: zobacz Wyświetl podgląd 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 aby wyświetlić podgląd 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. Formatowanie języka w normie ISO 639 i kraj/region w ISO 3166 oddzielone łącznikiem -. Na przykład: en-US.

Jeśli w kluczach mapy znajduje się język użytkownika, użytkownik zobaczy zlokalizowana wersja usługi 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 akceptować obiekt zdarzenia zawierający jako argument EDITOR_NAME.matchedUrl.url i zwrócić pojedynczą 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 zostanie pominięty, zostanie dodana 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 wyrażenia 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 URL to support.example.com, aby dopasować adresy URL do zgłoszeń hostowanych w support.example.com/cases/, użyj cases.

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

CreateActionTriggers

Konfiguracja reguły, która uruchamia się, gdy użytkownik wybierze firmę zewnętrzną w menu @ w Dokumentach Google.

Aby skonfigurować ten aktywator dla dodatku do Google Workspace: zobacz Tworzenie 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 wyróżniający to rozszerzenie . Identyfikator może mieć do 64 znaków i powinien być w formacie [a-zA-Z0-9-]+.
labelText

string

Wymagane. Tekst widoczny w znaku @. menu, takie jak Create support case.
localizedLabelText

map (key: string, value: string)

Opcjonalnie: Mapa: labelText do zlokalizowania na inne języki. Formatowanie języka w normie ISO 639 i kraj/region w ISO 3166 oddzielone łącznikiem -. Na przykład: en-US.

Jeśli w kluczach mapy znajduje się język użytkownika, użytkownik zobaczy zlokalizowana wersja usługi 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 zostanie pominięty, zostanie dodana ikona na pasku narzędzi: logoUrl.