Słowniczek

Poniższe terminy są używane w tej dokumentacji.

Dodatek do rozmów wideo w Kalendarzu

Specjalny rodzaj dodatku, który umożliwia dostawcom usług wideo prezentowanie opcji rozmów wideo w wydarzeniach w Kalendarzu Google. Aby można było połączyć te dodatki, potrzebują one dobrze opracowanego rozwiązania do obsługi rozmów wideo. Z tego powodu większość deweloperów nigdy nie musi tworzyć dodatku do rozmów wideo w Kalendarzu.

Więcej informacji znajdziesz w artykule Dodatki do rozmów wideo w Kalendarzu. Zapoznaj się też z artykułem Uaktualnianie opublikowanych dodatków, aby dowiedzieć się, jak przekonwertować dodatek do rozmów wideo w Kalendarzu w dodatek do Google Workspace.

Karta

Pojedyncza „strona” interfejsu użytkownika dodatku. Karty składają się z różnych obiektów widżetów (przycisków, pól tekstowych, nagłówków itd.).

Więcej informacji znajdziesz w sekcji Karty.

Na podstawie kart

Dodatek, którego interfejs wyświetla się jako panel na pasku bocznym (lub na urządzeniu mobilnym jako kolejne okno aktywności dostępne z poziomu menu). Dodatek ma górny pasek narzędzi, który identyfikuje dodatek i wyświetla kartę – w zasadzie jest to „strona” jego interfejsu użytkownika.

Dodatki do Google Workspace są oparte na kartach.

Dane konferencji

Zestaw informacji, których Kalendarz Google potrzebuje, aby użytkownicy mogli tworzyć rozmowy wideo z użytkownikami zewnętrznymi i dołączać do nich za pomocą dodatku Google Workspace lub dodatku do obsługi rozmów wideo w Kalendarzu.

Więcej informacji znajdziesz w sekcji Dane rozmowy wideo.

Rozwiązanie konferencyjne

Obraz rozmowy zewnętrznej, którą można utworzyć w Kalendarzu Google za pomocą dodatku Google Workspace lub dodatku do rozmów wideo w Kalendarzu.

Więcej informacji znajdziesz w artykule Rozwiązania konferencyjne.

kontekst,

Bieżący stan aplikacji hosta. Na przykład możesz zobaczyć, która wiadomość jest obecnie otwarta w Gmailu, które wydarzenie w Kalendarzu edytujesz lub które pliki na Dysku są częścią bieżącego kontekstu aplikacji hosta. Kontekst i inne informacje są zbierane do obiektu zdarzenia, który jest przekazywany do funkcji aktywującej jako parametr.

Uruchamianie kontekstowe

Definiuje reguły, które są uruchamiane, gdy użytkownik wchodzi w określony kontekst, na przykład gdy otwiera wątek e-maila w Gmailu. Dzięki aktywatorowi kontekstowemu dodatek może wyświetlać interfejs użytkownika dopasowany do tego kontekstu. Reguły kontekstowe są konfigurowane w pliku manifestu projektu dodatku i dlatego są rodzajem reguły w pliku manifestu.

Dodatki do edytora

Oryginalny zestaw typów dodatków, które zezwalały tylko na rozszerzenia Dokumentów, Arkuszy, Formularzy i Prezentacji Google. Dodatki do edytora nie są oparte na kartach, ale wymagały od dewelopera utworzenia interfejsu na podstawie nieprzetworzonego kodu HTML i CSS. Każdy dodatek do edytora może rozszerzać tylko jedną aplikację hosta.

Więcej informacji znajdziesz w artykule Dodatki do edytora.

Obiekt zdarzenia

Obiekt JSON, który jest tworzony automatycznie po otrzymaniu żądania strony głównej, gdy dodatek wchodzi w kontekst, na który musi odpowiedzieć, lub w wyniku interakcji użytkownika z widżetami w interfejsie dodatku. Po utworzeniu obiekty zdarzeń są przekazywane do określonej funkcji aktywatora lub wywołania zwrotnego. Obiekty zdarzeń służą do przekazywania informacji ze środowiska po stronie klienta użytkownika (np. informacji wprowadzonych w widżetach interfejsu dodatków) do kodu po stronie serwera dodatku, który następnie może podjąć działanie na podstawie tych informacji i zwrócić odpowiednią odpowiedź.

Więcej informacji znajdziesz w sekcji Obiekty zdarzeń.

Dodatki do Gmaila

Dodatek, który rozszerza tylko funkcje Gmaila. Dodatki w Gmailu są oparte na kartach. Wiele szczegółów dotyczących funkcjonalności, działania i programowania używanych podczas tworzenia dodatków do Gmaila jest identycznych jak te używane podczas tworzenia dodatków do Google Workspace.

Więcej informacji znajdziesz w artykule o dodatkach do Gmaila. W sekcji Uaktualnianie opublikowanych dodatków znajdziesz też informacje o tym, jak przekonwertować dodatek Gmail na dodatek do Google Workspace.

Strona główna

Główna karta interfejsu dodatku. Strony główne wyświetlają się, gdy użytkownicy otwierają dodatek i umożliwiają mu wyświetlanie treści spoza określonego kontekstu (na przykład gdy użytkownik przegląda wątki e-mail w Gmailu, ale go nie otworzył). To Ty określasz wygląd i działanie strony głównej dodatku tak jak każdej innej karty.

Więcej informacji znajdziesz w artykule Strony główne.

Host lub aplikacja hostująca

Aplikacja Google Workspace będąca dodatkiem do Google Workspace, np. Gmail lub Kalendarz Google.

Oparta na HTML

Dodatek, którego interfejs użytkownika jest zdefiniowany przy użyciu kodu HTML i CSS, a nie wbudowanej usługi Card. Tylko starsze dodatki do edytora są oparte na HTML.

Podgląd linków uruchamia się, gdy użytkownik wchodzi w interakcję z adresem URL firmy zewnętrznej lub adresem URL firmy innej niż Google w aplikacji hosta Google, takiej jak Dokumenty Google. Aktywowanie podglądu linku umożliwia definiowanie wzorców adresów URL, których podgląd chcesz wyświetlić z poziomu usługi lub interfejsu API, oraz konfigurowanie treści podglądu, w tym elementu inteligentnego i karty podglądu. Aktywatory podglądu linku są konfigurowane w pliku manifestu projektu dodatku i dlatego są typem aktywatora pliku manifestu.

Więcej informacji znajdziesz w artykule Podgląd linków w Dokumentach Google.

Plik manifestu

Plik JSON dołączony do projektu Apps Script. Plik manifestu służy do określania informacji o projekcie, które powinny być prawidłowo uruchamiane przez skrypt. W przypadku dodatków do Google Workspace plik manifestu służy do określania hostów, które może on rozszerzać, oraz do określania ustawień elementów sterujących interfejsu użytkownika.

Aktywator w pliku manifestu

Aktywator określony w pliku manifestu projektu, taki jak reguła uruchamiająca na stronie głównej lub reguła kontekstowa. Aktywatory w pliku manifestu są używane wyłącznie do tworzenia i wyświetlania nowych kart, gdy zostanie wysłane żądanie strony głównej dodatku lub dodatek wejdzie w kontekst wymagający aktualizacji sposobu wyświetlania.

Aktywatory pliku manifestu różnią się od innych aktywatorów w Apps Script, ponieważ nie są wbudowane (np. proste wyzwalacze) i nie można ich automatycznie tworzyć za pomocą usługi skryptu Apps Script (np. reguł instalowanych).

Karty niekontekstowe

Karty, które wyświetlają się, gdy użytkownik znajduje się poza określonym kontekstem, np. gdy wyświetla wątki e-maili w Gmailu, ale go nie otworzył. Strony główne to karty niekontekstowe.

Sekcja po prawej stronie interfejsu hosta, w której pojawia się interfejs dodatku do Google Workspace. Dodatki do Gmaila i Edytora mogą też definiować paski boczne.

Element inteligentny

Element inteligentny to wzmianka o osobie, pliku, wydarzeniu w kalendarzu lub innym elemencie w aplikacji Google Workspace. Gdy użytkownik najedzie kursorem na element, może też wyświetlić podgląd dodatkowych treści dotyczących pliku lub linku. Na przykład gdy użytkownik najedzie kursorem na element w Prezentacjach Google, zobaczy zrzut ekranu ze slajdem, właściciela prezentacji oraz informację, czy już ją wyświetlił.

Możesz skonfigurować dodatek tak, aby używał elementów inteligentnych do wyświetlania podglądu linków usług innych firm lub usług innych firm. Zobacz Podgląd linków w Dokumentach Google.

Aktywator

Warunek i automatyczna odpowiedź na zdarzenie zdefiniowana przez projekt lub dodatek Apps Script. Aktywatory są uruchamiane, gdy wystąpi powiązane z nimi zdarzenie (np. otwarcie dodatku) i spowoduje automatyczne wykonanie określonej funkcji Apps Script (funkcji aktywatora). W przypadku dodatków do Google Workspace funkcje aktywujące często tworzą nowe karty, aby kontrolować, która część interfejsu dodatków jest wyświetlana. Tylko niektóre typy zdarzeń mogą mieć reguły.

Więcej informacji znajdziesz w sekcji Wyzwalacze dodatków.

Funkcja aktywatora

Funkcja Apps Script w projekcie, która jest wykonywana w odpowiedzi na uruchomienie aktywatora.

Widżet

Element interfejsu, taki jak przycisk, pole tekstowe lub pole wyboru. Karty są tworzone na podstawie sekwencji obiektów widżetów zdefiniowanych przez wbudowaną usługę Card (wbudowaną) Apps Script.

Więcej informacji znajdziesz w sekcji Widżety.

Funkcja obsługi widżetu

Funkcja łącząca konkretny widżet z konkretnym obiektem czynności. Każdy typ widżetu ma zestaw zdefiniowanych funkcji obsługi widżetów, których można używać do łączenia się z działaniami. Funkcje obsługi widżetów określają, jaki rodzaj interakcji użytkownika uruchamia wynikowe działanie i są kluczowym elementem interakcji z widżetami.

Więcej informacji znajdziesz w sekcji Funkcje modułu obsługi widżetów.