Zasób pliku manifestu dodatków

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Konfiguracja zasobów używana do definiowania treści i działania Google Workspace dodatku. Google Workspace Manifest dodatku musi zawierać wszystkie komponenty oznaczone jako Wymagane.

Dodatki

Najwyższy poziom Google Workspace konfiguracji pliku manifestu dodatku.

Zapis JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Pola
common

object (Common)

Wymagany. Określa wartości Google Workspace dodatku, które jest typowe w każdej aplikacji hosta. Niektóre zdefiniowane tutaj wartości są używane jako wartości domyślne, gdy określone wartości określonego hosta są pomijane.

calendar

object (Calendar)

Wymagany, jeśli Google Workspace dodatek rozszerza Kalendarz. Konfiguracje Google Workspace dodatku i zachowania dodatku w aplikacji hosta Kalendarza Google. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Kalendarzu Google.

drive

object (Drive)

Wymagany, jeśli Google Workspace dodatek rozszerza Dysk Google. Konfiguracje Google Workspace dodatku i zachowania dodatku w aplikacji hosta Dysku Google. Jeśli pominiesz to pole, dodatek zostanie wyłączony na Dysku Google.

gmail

object (Gmail)

Wymagany, jeśli Google Workspace dodatek rozszerza Gmaila. Konfiguracje Google Workspace dodatku i zachowania dodatku w aplikacji hosta Gmaila. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Gmailu.

docs

object (Docs)

Wymagany, jeśli Google Workspace dodatek rozszerza Dokumenty. Konfiguracje Google Workspace wyglądu i zachowania dodatku w aplikacji hostującej Dokumenty. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Dokumentach.

sheets

object (Sheets)

Wymagany, jeśli Google Workspace Dodatek rozszerza Arkusze. Konfiguracje Google Workspace wyglądu i zachowania dodatku w aplikacji hosta Arkuszy. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Arkuszach.

slides

object (Slides)

Wymagany, jeśli Google Workspace dodatek rozszerza Prezentacje. Konfiguracje dodatku Google Workspace dodatku i zachowania dodatku w aplikacji hosta Prezentacji. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Prezentacjach.

Często wybierane

Konfiguracja pliku manifestu parametrów, które są typowe dla każdej aplikacji hosta. Niektóre zdefiniowane tutaj wartości są używane jako wartości domyślne, gdy określone wartości dotyczące konkretnego hosta są pomijane.

Zapis JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Pola
homepageTrigger

object (HomepageTrigger)

Domyślna specyfikacja funkcji aktywatora do tworzenia strony głównej dodatku. Ta specyfikacja jest używana, jeśli nie określono aktywatora strony głównej konkretnego hosta. W przypadku pominięcia tej informacji tworzona jest ogólna karta strony głównej, która w razie potrzeby jest używana.
layoutProperties

object (LayoutProperties)

Konfiguracja kolorów używanych na pasku narzędzi i przyciskach dodatku.
logoUrl

string

Wymagany. Adres URL obrazu wyświetlanego na pasku narzędzi. Adres URL musi być publiczny.

name

string

Wymagany. Nazwa dodatku widoczna na pasku narzędzi.

openLinkUrlPrefixes[]

string

Wymagany, jeśli dodatek wyświetla linki wychodzące zarówno w widżetach korzystających z OpenLink, jak i w widżecie tekstowym przy użyciu tagów kotwicy HTML. Lista prefiksów adresów URL HTTPS. Aby chronić dane użytkowników, każdy link renderowany przez dodatek musi być zgodny z jednym z prefiksów na tej liście.

Więcej informacji znajdziesz w sekcji Lista dozwolonych adresów URL.

universalActions[]

object (UniversalAction)

Lista działań uniwersalnych, które są zawsze dostępne w interfejsie dodatku.
useLocaleFromApp

boolean

Jeśli true, obiekty zdarzeń przekazywane do funkcji wywołania zwrotnego lub funkcji aktywatora zawierają informacje o języku i strefie czasowej użytkownika. Domyślna wartość to false.

Więcej informacji znajdziesz w artykule na temat uzyskiwania dostępu do ustawień regionalnych i stref czasowych użytkowników.

Właściwości układu

Konfiguracja kontrolująca Google Workspace dobór i kolory paska narzędzi dodatku oraz wyglądu przycisku.

Zapis JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
Pola
primaryColor

string

Kolor paska narzędzi. Domyślnie jest to szary (424242).
secondaryColor

string

Domyślny kolor przycisków. Domyślny kolor to podstawowy (jeśli jest ustawiony). W przeciwnym razie przyjmuje kolor niebieski (#2196F3).

Działanie uniwersalne

Konfiguracja działania uniwersalnego. Jeśli wybierzesz tę opcję, działanie uniwersalne spowoduje otwarcie linku do określonego adresu URL lub uruchomienie określonej funkcji Apps Script.

Zapis JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Pola
label

string

Wymagane na każde uniwersalne działanie. Tekst wyświetlany w menu interfejsu dla tej czynności.
runFunction

string

Wymagane w przypadku każdego działania uniwersalnego, jeśli nie ma właściwości openLink. Nazwa funkcji Apps Script uruchamiana, gdy użytkownik ją wybierze, jeśli została podana.

Więcej informacji znajdziesz w przewodniku po działaniach uniwersalnych.