Zasób manifestu dodatków

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

AddOns

Konfiguracja najwyższego poziomu w manifeście dodatku do 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 do Google Workspace, które są wspólne dla każdej aplikacji hosta. Niektóre zdefiniowane tutaj wartości są używane jako domyślne, gdy brakuje określonych wartości dla danego hosta.

calendar

object (Calendar)

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

chat

object ()

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

Obiekt addOns.chat musi być pusty. Aby skonfigurować działanie i wygląd dodatku w Google Chat, zapoznaj się z artykułem Konfigurowanie aplikacji do obsługi czatu.
drive

object (Drive)

Wymagane, 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)

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

docs

object (Docs)

Wymagane, 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)

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

slides

object (Slides)

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

Często wybierane

Konfiguracja manifestu dla parametrów wspólnych dla każdej aplikacji hostującej. Niektóre zdefiniowane tutaj wartości są używane jako domyślne, gdy brakuje określonych wartości dla danego hosta.

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 do tworzenia strony głównej dodatku. Ta specyfikacja jest używana, jeśli nie zdefiniowano wyzwalacza strony głównej dla konkretnego hosta. Jeśli ten element również zostanie pominięty, 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

Wymagane, 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żetach tekstowych używających tagów kotwicy HTML. Lista prefiksów adresów URL HTTPS. Aby chronić dane użytkowników, każdy link renderowany przez dodatek musi pasować do jednego z prefiksów na tej liście.

Więcej informacji znajdziesz w sekcji Lista adresów URL, które mogą używać protokołu HTTP.

universalActions[]

object (UniversalAction)

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

boolean

Jeśli true, obiekty zdarzeń dodatku przekazywane do funkcji wywołania zwrotnego działania lub funkcji wyzwalacza 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.

LayoutProperties

Konfiguracja, która kontroluje Google Workspacekolory i wygląd paska narzędzi i przycisków dodatku.

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

string

Kolor paska narzędzi. Domyślna wartość to szary (#424242).
secondaryColor

string

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

UniversalAction

Konfiguracja działania uniwersalnego. Po wybraniu działania uniwersalnego otworzy się określony link URL lub zostanie uruchomiona określona funkcja 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 tego działania.
runFunction

string

Wymagany w przypadku każdego działania uniwersalnego, jeśli nie ma elementu openLink. Jeśli podano nazwę funkcji Apps Script, która ma być wykonywana, gdy użytkownik wybierze to działanie.

Szczegółowe informacje znajdziesz w przewodniku Działania uniwersalne.