Zasób manifestu dodatków

Konfiguracja zasobów używana do definiowania treści i działania dodatku do Google Workspace. Pliki MANIFEST dodatków 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. Określa wartości dodatku Google Workspace, które są wspólne dla wszystkich aplikacji hosta. Niektóre z definiowanych tu wartości są używane jako domyślne, gdy pominięto konkretne wartości dla konkretnego hosta.

calendar

object (Calendar)

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

drive

object (Drive)

Wymagany, jeśli dodatek do Google Workspace rozszerza możliwości Dysku 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)

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

docs

object (Docs)

Wymagane, jeśli dodatek Google Workspace rozszerza Dokumenty Google. 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 Google Workspace w aplikacji hosta Arkuszy. Jeśli pominiesz to pole, w Sheets będzie wyłączone.

slides

object (Slides)

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

Typowe

Konfiguracja pliku manifestu dla parametrów wspólnych dla każdej aplikacji hosta. Niektóre z zdefiniowanych tu wartości są używane jako domyślne, gdy konkretne wartości dla konkretnego 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)

Domyślna specyfikacja funkcji reguły na potrzeby tworzenia strony głównej dodatku. Ta specyfikacja jest używana, jeśli nie zdefiniowano wyzwalacza strony głównej dla hosta. Jeśli nie podasz też tej wartości, w razie potrzeby zostanie utworzona i użyta ogólna karta strony głównej.
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 wyświetlana na pasku narzędzi.

openLinkUrlPrefixes[]

string

Wymagany, jeśli dodatek wyświetla jakiekolwiek linki wychodzące, niezależnie od tego, czy znajdują się one w widżetach korzystających z  OpenLink, czy w widżecie tekstowym korzystającym z tagów kotwicy HTML. Lista prefiksów adresów URL HTTPS. Aby chronić dane użytkownika, każdy link renderowany przez dodatek musi być zgodny z jednym z prefiksów na tej liście.

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

universalActions[]

object (UniversalAction)

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

boolean

Jeśli true, dodatki obiekty zdarzeń przekazywane do funkcji wywołania akcji lub funkcji uruchamiających 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ń języka i strefy czasowej użytkownika.

LayoutProperties

Konfiguracja, która kontroluje kolory i wygląd paska narzędzi oraz przycisków Google Workspacerozszerzenia.

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

string

Kolor paska narzędzi. Domyślny kolor to szary (#424242).
secondaryColor

string

Domyślny kolor przycisków. Domyślnie jest to kolor podstawowy (jeśli został ustawiony), w przeciwnym razie jest to kolor niebieski (#2196F3).

UniversalAction

Konfiguracja działania uniwersalnego. Po wybraniu działanie uniwersalne otwiera określony link 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 dla każdego działania uniwersalnego. Tekst wyświetlany w menu tego działania.
runFunction

string

Wymagany dla każdego działania uniwersalnego, jeśli nie podano openLink. W razie podania nazwa funkcji Apps Script, która jest wykonywana, gdy użytkownik wybierze to działanie.

Szczegółowe informacje znajdziesz w  przewodniku dotyczącym działań uniwersalnych.