Ta strona została przetłumaczona przez Cloud Translation API.

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) } }

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

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.

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`.