Zasób manifestu Gmaila

Konfiguracja zasobów używana do definiowania treści i działania dodatku do Google Workspace w Gmailu. Pliki manifestu dodatku do Google Workspace, które rozszerzają Gmaila, muszą zawierać wszystkie komponenty oznaczone jako Wymagane.

Gmail

Konfiguracja pliku manifestu dodatku do Google Workspace dla rozszerzeń Gmaila. Więcej informacji znajdziesz w artykule Rozszerzanie możliwości Gmaila za pomocą dodatków 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 innych firm. Ta funkcja jest wywoływana przed każdym wywołaniem dodatku do Google Workspace.

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

composeTrigger

object (ComposeTrigger)

Wymagany w przypadku tworzenia wiadomości. Określa zestaw interfejsów użytkownika dostępnych dla użytkownika podczas pisania e-maila.

Więcej informacji znajdziesz w sekcji o rozszerzaniu interfejsu tworzenia wiadomości za pomocą działań tworzenia wiadomości.

contextualTriggers[]

object (ContextualTrigger)

Wymagane. Lista aktywatorów, które uruchamiają się po otwarciu wiadomości w Gmailu. Po uruchomieniu aktywator wykonuje określoną funkcję Apps Script, zwykle w celu utworzenia nowych kart i zaktualizowania interfejsu użytkownika.
homepageTrigger

object (HomepageTrigger)

Specyfikacja funkcji aktywatora służącej do tworzenia strony głównej dodatku na hoście Gmaila. Zastępuje to instancję addOns.common.homepageTrigger.

ComposeTrigger

Konfiguracja działania tworzenia. Więcej informacji znajdziesz w artykule Przedłużanie interfejsu tworzenia wiadomości.

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

string

Określa poziom dostępu do danych dla funkcji aktywatora tworzenia. Możliwe opcje:

  • NONE (ustawienie domyślne). Przez to obiekt zdarzenia przekazywany do funkcji aktywatora tworzenia jest przeważnie pusty.
  • METADATA, który wypełnia obiektem zdarzenia przekazywanym do funkcji aktywatora tworzenia listami odbiorców wiadomości. To ustawienie wymaga, aby dodatek obejmował zakres gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Lista działań tworzenia, które tworzą interfejsy tworzenia wiadomości. Jest jednak ograniczona do jednego działania na dodatek. To działanie ma przypisaną ikonę w oknie tworzenia wiadomości w Gmailu. Ikona jest określana przez gmail.logoUrl.

ContextualTrigger

Konfiguracja reguły uruchamianej, gdy użytkownik otworzy wiadomość w Gmailu, która spełnia określone kryteria. Więcej informacji znajdziesz w artykule Przedłużanie interfejsu wiadomości.

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

string

Wymagane w przypadku każdego wyzwalacza kontekstowego. Nazwa funkcji Apps Script wykonywanej po uruchomieniu aktywatora.

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

unconditional

object

Wymagane w przypadku każdego wyzwalacza kontekstowego. Służy do określania, czy aktywator kontekstowy ma się aktywować w przypadku wszystkich wiadomości Gmaila, gdy są one otwarte. Obecnie jest to jedyna opcja, więc zawsze powinien być pusty.

SelectAction

Konfiguracja działania tworzenia wiadomości, która określa, która funkcja zostanie uruchomiona, gdy użytkownik wybierze to działanie.

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

string

Wymagany w przypadku tworzenia wiadomości. Nazwa funkcji Apps Script, która jest wykonywana po wybraniu tego działania tworzenia. Ta funkcja aktywatora tworzenia kompiluje interfejs tworzenia dodatkowego dodatku.

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

text

string

Wymagany w przypadku tworzenia wiadomości. Krótki opis działania tworzenia wiadomości.