Zasób manifestu dodatków

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

Dodatki

Najwyższy poziom konfiguracji pliku manifestu dodatku do Google Workspace.

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)

Wymagane. Definiuje wartości dodatku do Google Workspace, które są wspólne dla każdej aplikacji hosta. Niektóre wartości zdefiniowane tutaj są używane jako domyślne, gdy określone wartości dla określonego hosta są pominięte.

calendar

object (Calendar)

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

drive

object (Drive)

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

gmail

object (Gmail)

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

docs

object (Docs)

Wymagany, jeśli dodatek do Google Workspace rozszerza Dokumenty. Konfiguracje wyglądu i działania dodatku do Google Workspace w aplikacji hosta Dokumentów. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Dokumentach.

sheets

object (Sheets)

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

slides

object (Slides)

Wymagany, jeśli dodatek do Google Workspace rozszerza Prezentacje. Konfiguracje wyglądu i działania dodatku do Google Workspace w aplikacji hosta Prezentacje. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Prezentacjach.

Często wybierane

Konfiguracja pliku manifestu dla parametrów, które są wspólne dla każdej aplikacji hosta. Niektóre wartości zdefiniowane w tym miejscu są używane jako domyślne, gdy określone wartości dla określonego hosta są pominięte.

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

object (HomepageTrigger)

Specyfikacja domyślnej funkcji aktywatora do tworzenia strony głównej dodatku. Ta specyfikacja jest używana, jeśli nie zdefiniowano aktywatora strony głównej zależnej od hosta. Jeśli go też pominiesz, zostanie utworzona i używana w razie potrzeby ogólna karta strony głównej.
layoutProperties

object (LayoutProperties)

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

string

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

name

string

Wymagane. Nazwa dodatku widoczna na pasku narzędzi.

openLinkUrlPrefixes[]

string

Wymagany, jeśli dodatek wyświetla jakiekolwiek linki wychodzące, zarówno w widżetach korzystających z OpenLink, jak i widżetach tekstowych korzystających z tagów kotwicy HTML. Lista prefiksów adresów URL HTTPS. Aby chronić dane użytkownika, każdy link renderowany przez dodatek musi pasować do jednego z prefiksów na tej liście.

Więcej informacji znajdziesz w sekcji Umieszczanie adresów URL na liście dozwolonych.

universalActions[]

object (UniversalAction)

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

boolean

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

Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do ustawień regionalnych i stref czasowych użytkownika.

Właściwości układu

Konfiguracja, która kontroluje kolor i wygląd Google Workspacepaska narzędzi dodatku oraz przycisków.

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ślnie jest to kolor podstawowy (jeśli jest ustawiony). W przeciwnym razie jest to kolor niebieski (#2196F3).

Uniwersalne działanie

Konfiguracja działania uniwersalnego. Jeśli wybierzesz tę opcję, działanie uniwersalne otwiera określony link z adresem URL lub uruchamia określoną funkcję 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

Wymagany w przypadku każdego działania uniwersalnego. Tekst wyświetlany w menu interfejsu oznaczający tę czynność.
runFunction

string

Wymagany w przypadku każdego działania uniwersalnego, jeśli nie określono openLink. Jeśli została podana, nazwa funkcji Apps Script, która jest wykonywana, gdy użytkownik wybierze to działanie.

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