Zasób pliku manifestu edytora

Konfiguracja zasobów, która służy do definiowania treści i zachowania dodatku do Google Workspace w edytorach. Pliki manifestu dodatków do Google Workspace muszą zawierać wszystkie komponenty oznaczone jako Wymagane, jeśli rozszerzają działanie Edytora.

Edytujący

Konfiguracja pliku manifestu dodatku Google Workspace dla rozszerzeń Edytora. Więcej informacji znajdziesz w artykule na temat rozwijania edytorów dzięki dodatkom do Google Workspace.

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

object (HomepageTrigger)

Ta funkcja aktywatora tworzy stronę główną dodatku w aplikacji hosta. Ta funkcja zastępuje addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Wymagane, jeśli dodatek uwzględnia zachowanie charakterystyczne dla bieżącego dokumentu Edytora, aktywowane, gdy użytkownik autoryzuje zakres drive.file .

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Wymagane w przypadku podglądu linków. Lista reguł służących do wyświetlania podglądu linków w dokumencie Dokumentów Google. Szczegółowe informacje znajdziesz w artykule Wyświetlanie podglądu linków za pomocą elementów inteligentnych.

OnFileScopeGrantedtrigger

Konfiguracja aktywatora kontekstowego, która jest uruchamiana, gdy okno zakresu pliku żądania z użyciem CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();, a użytkownik przyzna autoryzację zakresu drive.file.

Zapis JSON
{
  "runFunction": string
}
Pola
runFunction

string

Nazwa funkcji do uruchomienia po przyznaniu zakresu drive.file. Jeśli ta funkcja jest określona, musisz wdrożyć tę funkcję, by skompilować i zwrócić tablicę obiektów Card do wyświetlenia w interfejsie dodatku.

Wyzwalacze podglądu linku

Konfiguracja reguły uruchamianej, gdy użytkownik wpisze lub wklei link z usługi firmy innej niż Google lub z usługi firmy innej niż Google w dokumencie w Dokumentach Google.

Aby skonfigurować tę regułę w przypadku dodatku do Google Workspace, przeczytaj artykuł Wyświetlanie podglądu linków z elementami inteligentnymi.

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

string

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

map

Opcjonalnie. Mapa labelText do zlokalizowania na inne języki. Sformatuj język zgodnie z normą ISO 639, a kraj/region w formacie ISO 3166, oddzielając go łącznikiem -. Na przykład: en-US.

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

patterns[]

object (UriPattern)

Wymagane. Tablica wzorców adresów URL, które uruchamiają dodatek, aby wyświetlić podgląd linków.
runFunction

string

Wymagane. Nazwa funkcji, która ma być uruchamiana, gdy użytkownik autoryzuje zakres https://www.googleapis.com/auth/workspace.linkpreview. Jeśli ją określisz, musisz zaimplementować tę funkcję, by akceptować jako argument obiekt zdarzenia zawierający docs.matchedUrl.url i zwracać pojedynczy obiekt Card, który wyświetla podgląd linku w interfejsie dodatku.
logoUrl

string

Opcjonalnie. Ikona wyświetlana w elemencie inteligentnym. Jeśli ten argument zostanie pominięty, element będzie używał ikony dodatku na pasku narzędzi – logoUrl.

Wzorzec identyfikatora URI

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

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

string

Wymagane dla każdego wzorca adresu URL na potrzeby podglądu. 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 dla określonej subdomeny, np. subdomain.example.com, uwzględnij ją. Aby wyświetlać podgląd linków w całej domenie, jako subdomenę podaj symbol wieloznaczny z gwiazdką (*).

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

pathPrefix

string

Opcjonalnie. Ścieżka dołączająca domenę hostPattern.

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

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