Zasób manifestu Gmaila

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

Gmail

Konfiguracja pliku manifestu dodatku do Google Workspace dla rozszerzeń Gmaila. Więcej informacji znajdziesz w artykule o rozszerzaniu możliwości Gmaila o dodatki do Google Workspace.

Zapis JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Pola
authorizationCheckFunction

string

Wycofano. Nazwa funkcji Apps Script, która sprawdza wymagania autoryzacji przez podmioty zewnętrzne. Ta funkcja jest wywoływana przed każdym wywołaniem dodatku Google Workspace.

Ta funkcja została wycofana, aby uniknąć niepotrzebnego opóźnienia podczas wykonywania. Zamiast tego dodatek powinien zgłaszać wyjątek od głównego wywołania, jak widać w tym przykładzie.

composeTrigger

object (ComposeTrigger)

Wymagane do działań tworzenia. Określa zestaw interfejsów użytkownika, z których użytkownik może korzystać podczas pisania e-maila.

Więcej informacji znajdziesz w sekcji Rozszerzanie interfejsu tworzenia wiadomości o działania związane z tworzeniem wiadomości.

contextualTriggers[]

object (ContextualTrigger)

Wymagane. Lista reguł, które uruchamiają się, gdy wiadomość otwiera się w Gmailu. Uruchomienie aktywatora powoduje wykonanie określonej funkcji Apps Script, zwykle w celu utworzenia nowych kart i zaktualizowania interfejsu użytkownika.
homepageTrigger

object (HomepageTrigger)

Specyfikacja funkcji aktywującej tworzenie strony głównej dodatku na hoście Gmaila. Zastępuje instancję addOns.common.homepageTrigger.

ComposeTrigger

Konfiguracja działania tworzenia wiadomości. Więcej informacji znajdziesz w artykule na temat przedłużania interfejsu tworzenia wiadomości.

Zapis JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Pola
draftAccess

string

Określa poziom dostępu do danych dostępny dla funkcji aktywatora tworzenia. Prawidłowe opcje to:

  • NONE (ustawienie domyślne). To powoduje, że obiekt zdarzenia przekazywany do funkcji aktywatora tworzenia wiadomości jest w większości pusty.
  • METADATA, który wypełnia obiekt zdarzenia przekazany do funkcji aktywatora tworzenia wiadomości listami odbiorców wiadomości. To ustawienie wymaga, aby dodatek zawierał zakres gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Lista działań tworzenia, które tworzą interfejsy użytkownika, ale jest ona ograniczona do jednego działania na dodatek. Zadaniem tworzenia wiadomości jest ikona wyświetlana w oknie tworzenia wiadomości w Gmailu. Ikona jest określana przez gmail.logoUrl.

ContextualTrigger

Konfiguracja reguły, która ma być uruchamiana, gdy użytkownik otworzy wiadomość w Gmailu, która spełnia określone kryteria. Więcej informacji znajdziesz w artykule na temat rozszerzania interfejsu wiadomości.

Zapis JSON 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Pola
onTriggerFunction

string

Wymagane w przypadku każdej reguły kontekstowej. Nazwa funkcji Apps Script wykonywanej po uruchomieniu aktywatora.

Szczegółowe informacje o jej definiowaniu znajdziesz w sekcji Funkcja aktywatora kontekstowego.

unconditional

object

Wymagane w przypadku każdej reguły kontekstowej. Służy do określania, że aktywator kontekstowy będzie aktywowany dla wszystkich wiadomości w Gmailu po ich otwarciu. Obecnie jest to jedyna opcja, więc ten obiekt powinien zawsze być pusty.

SelectAction

Konfiguracja działania tworzenia wiadomości, która określa, która funkcja ma być uruchamiana, gdy użytkownik wybierze działanie tworzenia.

Zapis JSON 
{
  "runFunction": string,
  "text": string
}
Pola
runFunction

string

Wymagane do działań tworzenia. Nazwa funkcji Apps Script wykonywanej po wybraniu tego działania tworzenia. Ta funkcja aktywująca tworzenie dodatku kompiluje interfejs tworzenia dodatku.

Więcej informacji znajdziesz w sekcji o funkcji aktywatora tworzenia wiadomości.

text

string

Wymagane do działań tworzenia. Krótki opis tego działania tworzenia.