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

Zasób manifestu edytora

Konfiguracja zasobu, która służy do definiowania treści i działania dodatku Google Workspace w edytorach. Pliki manifestu dodatku Google Workspace muszą zawierać wszystkie komponenty oznaczone jako wymagane, jeśli rozszerzają edytor.

Edytujący

Konfiguracja pliku manifestu dodatku Google Workspace dla rozszerzeń edytora. Więcej informacji znajdziesz w artykule Rozszerzanie możliwości edytora za pomocą dodatków 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 wywołania tworzy stronę główną dodatku w aplikacji hosta. Zastępuje ona element `addOns.common.homepageTrigger`.
`onFileScopeGrantedTrigger`	`object (OnFileScopeGrantedTrigger)` Wymagane, jeśli dodatek zawiera zachowanie specyficzne dla bieżącego dokumentu w Edytorze, które jest wywoływane, gdy użytkownik autoryzuje zakres `drive.file`.
`linkPreviewTriggers[]`	`object (LinkPreviewTriggers)` Wymagany w przypadku podglądu linków. Lista czynników wyzwalających podgląd linków w pliku Dokumentów, Arkuszy lub Prezentacji Google. Więcej informacji znajdziesz w artykule Wyświetlanie podgląd linku za pomocą elementów inteligentnych.
`createActionTriggers[]`	`object (createActionTriggers)` Wymagany do tworzenia zasobów innych firm. Lista aktywatorów tworzenia zasobów w usłudze innej firmy z menu @. Szczegółowe informacje znajdziesz w artykule Tworzenie zasobów zewnętrznych za pomocą elementów inteligentnych.

OnFileScopeGrantedTrigger

Konfiguracja kontekstowego aktywatora, który uruchamia okno CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); i udziela użytkownikowi uprawnienia drive.file.

Zapis JSON
{ "runFunction": string }

Pola
`runFunction`	`string` Nazwa funkcji do uruchomienia, jeśli przyznano zakres `drive.file`. Jeśli to konieczne, musisz zaimplementować tę funkcję, aby utworzyć i zwrócić tablicę obiektów `Card` do wyświetlenia w interfejsie dodatku.

LinkPreviewTriggers

Konfiguracja reguły, która działa, gdy użytkownik wpisze lub wklei link z usługi innej firmy lub usługi innej niż Google do pliku Dokumentów, Arkuszy lub Prezentacji.

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

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

Pola
`labelText`	`string` Wymagany. 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ę przed uruchomieniem dodatku przez użytkowników.
`localizedLabelText`	`map (key: string, value: string)` Opcjonalnie: mapa `labelText` do zlokalizowania na inne języki. Formatuj język w formacie ISO 639, a kraj lub region w formacie ISO 3166, rozdzielając je łącznikiem `-`. Na przykład: `en-US`. Jeśli w kluczach mapy występuje lokalizacja użytkownika, zobaczy on zlokalizowaną wersję `labelText`.
`patterns[]`	`object (UriPattern)` Wymagany. Tablica wzorców adresów URL, które powodują, że dodatek wyświetla podgląd linków.
`runFunction`	`string` Wymagany. Nazwa funkcji, która ma być wykonywana, gdy użytkownik autoryzuje zakres `https://www.googleapis.com/auth/workspace.linkpreview`. Jeśli to konieczne, musisz zaimplementować tę funkcję, aby przyjmowała jako argument obiekt zdarzenia zawierający `EDITOR_NAME.matchedUrl.url` i zwracała pojedynczy obiekt `Card`, który wyświetla podgląd linku w interfejsie dodatku.
`logoUrl`	`string` Opcjonalnie: Ikona wyświetlana na elemencie inteligentnego elementu i karcie podglądu. Jeśli opcja ta zostanie pominięta, wtyczka będzie używać swojej ikony 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 w przypadku każdego wzorca adresu URL, aby wyświetlić podgląd. Domena wzorca adresu URL. linki w podglądzie dodatku, które zawierają tę domenę w adresie URL; Aby wyświetlić podgląd linków do konkretnej subdomeny, np. `subdomain.example.com`, uwzględnij tę subdomenę. Aby wyświetlić podgląd linków dla całej domeny, jako subdomeny użyj symbolu wieloznacznego, czyli gwiazdki (``). Na przykład `.example.com` pasuje do `subdomain.example.com` i `another.subdomain.example.com`.
`pathPrefix`	`string` Opcjonalnie: Ścieżka do domeny `hostPattern`. Jeśli np. wzór hosta adresu URL to `support.example.com`, aby dopasować adresy URL spraw hostowanych w witrynie `support.example.com/cases/`, użyj wzorca `cases`. Aby dopasować wszystkie adresy URL w domenie wzorca hosta, pozostaw pole `pathPrefix` puste.

hostPattern

string

Wymagany w przypadku każdego wzorca adresu URL, aby wyświetlić podgląd. Domena wzorca adresu URL. linki w podglądzie dodatku, które zawierają tę domenę w adresie URL; Aby wyświetlić podgląd linków do konkretnej subdomeny, np. subdomain.example.com, uwzględnij tę subdomenę. Aby wyświetlić podgląd linków dla całej domeny, jako subdomeny użyj symbolu wieloznacznego, czyli gwiazdki (*).

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

pathPrefix

string

Opcjonalnie: Ścieżka do domeny hostPattern.

Jeśli np. wzór hosta adresu URL to support.example.com, aby dopasować adresy URL spraw hostowanych w witrynie 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 uruchamia się, gdy użytkownik wybierze element menu integracji innej firmy w menu @ w Dokumentach Google.

Aby skonfigurować ten wyzwalacz dla dodatku Google Workspace, przeczytaj artykuł 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` Wymagany. Unikalny identyfikator umożliwiający odróżnienie tego punktu rozszerzenia. Identyfikator może mieć maksymalnie 64 znaki i powinien być w formacie `[a-zA-Z0-9-]+.`.
`labelText`	`string` Wymagany. Tekst, który pojawia się w menu @, np. `Create support case`.
`localizedLabelText`	`map (key: string, value: string)` Opcjonalnie: mapa `labelText` do zlokalizowania na inne języki. Formatuj język w formacie ISO 639, a kraj lub region w formacie ISO 3166, rozdzielając je łącznikiem `-`. Na przykład: `en-US`. Jeśli w kluczach mapy występuje lokalizacja użytkownika, zobaczy on zlokalizowaną wersję `labelText`.
`runFunction`	`string` Wymagany. Nazwa funkcji, która ma być wykonywana, gdy użytkownik wybierze punkt rozszerzenia w menu @. Funkcja powinna zwracać kartę formularza z danymi wejściowymi do utworzenia zasobu zewnętrznego.
`logoUrl`	`string` Opcjonalnie: Ikona wyświetlana w menu @. Jeśli opcja ta zostanie pominięta, wtyczka będzie używać swojej ikony na pasku narzędzi `logoUrl`.