Zasób manifestu dodatków

Konfiguracja zasobu, która służy do definiowania treści i działania dodatku Google Workspace. W pliku manifestu dodatku do Google Workspace wszystkie komponenty muszą być oznaczone jako wymagane.

AddOns

Konfiguracja najwyższego poziomu w pliku manifestu dodatku Google Workspace.

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

object (Common)

Wymagany. 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.

chat

object ()

Wymagane, jeśli dodatek Google Workspace rozszerza Chat. Konfiguracja aplikacji Google Chat. Jeśli to pole jest pominięte, dodatek jest wyłączony w Google Chat.

Obiekt addOns.chat musi być pusty. Aby skonfigurować działanie i wygląd dodatku w Google Chat, przeczytaj artykuł Konfigurowanie aplikacji Google Chat.

drive

object (Drive)

Wymagane, jeśli dodatek Google Workspace rozszerza Dysk Google. Konfiguracje wyglądu i działania dodatku Google Workspace w aplikacji gospodarza 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 gospodarza 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 Google Workspace w aplikacji hosta Dokumentów Google. Jeśli pominiesz to pole, dodatek zostanie wyłączony w Dokumentach.

sheets

object (Sheets)

Wymagane, jeśli dodatek 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 zostanie wyłączony w Prezentacjach.

Często wybierane

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 odpowiadać jednemu z prefiksów na tej liście.

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

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 w przypadku każdego działania uniwersalnego. Tekst wyświetlany w menu interfejsu dla tej czynności.
runFunction

string

Wymagany w przypadku każdego działania uniwersalnego, jeśli nie ma 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.