Zasób pliku manifestu edytora

Konfiguracja zasobów używana do definiowania dodatku i zachowania w edytorach. W przypadku plików manifestu dodatkowych rozszerzeń wszystkie komponenty muszą być oznaczone jako Wymagane.

Edytujący

Konfiguracja pliku manifestu dodatków do rozszerzeń Edytora Google Ads. Więcej informacji znajdziesz w artykule Rozszerzanie edytorów o dodatki.

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

object (HomepageTrigger)

Ta funkcja aktywująca tworzy stronę główną dodatku w aplikacji hostującej. Ta funkcja zastępuje addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Wymagany, jeśli dodatek obejmuje zachowanie związane z bieżącym dokumentem Edytora, wyzwalane, gdy użytkownik autoryzuje zakres drive.file .

linkPreviewTriggers

object (LinkPreviewTriggers)

Wymagany w przypadku podglądu linków. Określa wzorce adresów URL, które służą do wyświetlania podglądu treści w usłudze firmy zewnętrznej lub innej. Więcej informacji znajdziesz w artykule Podgląd linków w Dokumentach Google (wersja przedpremierowa) dla deweloperów.

Parametr OnFileScopeGrantedTrigger

Konfiguracja aktywatora kontekstowego uruchamianego, gdy dodatek wyświetla okno zakresu żądania za pomocą CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();, a użytkownik przyznaje autoryzację zakresu drive.file.

Zapis JSON
{
  "runFunction": string
}
Pola
runFunction

string

Nazwa funkcji do uruchomienia w przypadku przyznania zakresu drive.file. Jeśli ta funkcja jest określona, musisz ją wdrożyć, aby utworzyć i zwrócić tablicę obiektów Card do wyświetlenia w interfejsie dodatku.

Aktywatory linków podglądu

Konfiguracja reguły uruchamiającej się, gdy użytkownik wpisze lub wklei link do usługi Dokumenty Google lub usługi innej firmy niż Google.

Aby skonfigurować ten aktywator dla dodatku Google Workspace, zobacz Podgląd linków w Dokumentach Google (Wersja dla programistów).

Zapis JSON
{
  "labelText": string,
  "runFunction": string,
  "Icon": 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. Tekst ten jest statyczny i wyświetla się, zanim użytkownik uruchomi dodatek.
localizedLabelText

map

Opcjonalnie labelText, który jest przetłumaczony na inny język. Podaj język i identyfikator kraju/regionu w formacie kodu kraju w formacie ISO 639 – kodu ISO 3166. Na przykład: en-US.
runFunction

string

Nazwa funkcji do uruchomienia, gdy użytkownik autoryzuje zakres https://www.googleapis.com/auth/documents.readonly. Jeśli określisz tę funkcję, musisz zaimplementować tę funkcję, aby akceptować obiekty zdarzeń zawierające argument docs.matched.url jako argumenty i zwracać pojedynczy obiekt Card wyświetlający podgląd linku w interfejsie dodatku.
icon

string

Ikona wyświetlana w elemencie inteligentnym. W przypadku pominięcia tego elementu element używa ikony dodatku na pasku narzędzi: logoUrl.
patterns

object (Patterns)

Wymagany. Tablica wzorców adresów URL, które powodują uruchamianie dodatku w linkach do podglądu.

Wzory

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

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

string

Wymagany dla każdego wzorca adresu URL do wyświetlenia podglądu. Domena wzorca adresu URL. Podgląd dodatku prowadzi do tej domeny. Aby wyświetlić podgląd linków do określonej subdomeny, na przykład subdomain.example.com, dołącz ją. Aby wyświetlić podgląd linków w całej domenie, określ jako symbol wieloznaczny symbol wieloznaczny (*).

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

pathPrefix

string

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

Jeśli na przykład wzorzec adresu URL hosta to support.example.com, aby dopasować adresy URL do zgłoszeń hostowanych w domenie support.example.com/cases/, wpisz cases.

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