Słownik

W tej dokumentacji używane są następujące terminy.

Dodatek do rozmów wideo w Kalendarzu

Specjalny rodzaj dodatku, który umożliwia firmom do obsługi rozmów wideo prezentowanie opcji rozmów wideo w wydarzeniach w Kalendarzu Google. Te dodatki wymagają dobrze opracowanego rozwiązania do obsługi rozmów wideo, z którym można się połączyć. Z tego względu większość deweloperów nigdy nie musi tworzyć dodatku do rozmów w Kalendarzu.

Więcej informacji znajdziesz w artykule Dodatki do rozmów wideo w Kalendarzu. Zapoznaj się też z sekcją Uaktualnianie opublikowanych dodatków, aby dowiedzieć się, jak przekształcić 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 itp.).

Więcej informacji znajdziesz w artykule Karty.

Na podstawie karty

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

Dodatki do Google Workspace działają na podstawie kart.

Dane konferencji

Zbiór informacji, których Kalendarz Google potrzebuje, aby umożliwić użytkownikom tworzenie rozmów wideo z usługami innych firm i dołączanie do nich w ramach dodatku do Google Workspace lub dodatku do Kalendarza.

Więcej informacji znajdziesz w sekcji Dane konferencji.

Rozwiązanie konferencyjne

Prezentacja rozmowy wideo innej firmy, którą można utworzyć w Kalendarzu Google za pomocą dodatku do Google Workspace lub dodatku do Kalendarza.

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

Kontekst

Bieżący stan aplikacji hosta. Na przykład: która wiadomość aktualnie otwiera się w Gmailu, które wydarzenie w Kalendarzu edytujesz lub wybrane pliki na Dysku, są częścią bieżącego kontekstu aplikacji hosta. Kontekst wraz z innymi informacjami jest rejestrowany w obiekcie zdarzenia, który jest przekazywany jako parametr do funkcji aktywującej.

Wyzwalanie kontekstowe

Definiowanie reguł, które uruchamiają się, gdy użytkownik wpisze określony kontekst, na przykład otworzy wątek e-maili w Gmailu. Dzięki wyzwalaniu kontekstowemu dodatek może wyświetlać interfejs odpowiedni do danego kontekstu. Reguły kontekstowe konfiguruje się w pliku manifestu projektu skryptu dodatkowego, dlatego są typem reguły manifestu.

Dodatki do edytora

Pierwotny zestaw typów dodatków, które zezwalały wyłącznie na rozszerzenia Dokumentów, Arkuszy, Formularzy i Prezentacji Google. Dodatki do edytora nie działają na kartach. Wymagają od dewelopera tworzenia interfejsu z nieprzetworzonego kodu HTML i CSS. Każdy dodatek do edytora może rozszerzyć tylko jedną aplikację hosta.

Więcej informacji znajdziesz w artykule Dodatki do edytora.

Obiekt zdarzenia

Obiekt JSON, który jest tworzony automatycznie po wysłaniu żądania udostępnienia strony głównej, gdy dodatek wprowadza kontekst, na który ma reagować, lub w wyniku interakcji użytkowników z widżetami w interfejsie dodatku. Po utworzeniu obiekty zdarzeń są przekazywane do określonej funkcji aktywatora lub funkcji wywołania zwrotnego. Obiekty zdarzeń służą do przekazywania informacji ze środowiska po stronie klienta (np. informacji wprowadzonych w widżetach interfejsu dodatku) do kodu po stronie serwera dodatku, który następnie może wykonać odpowiednie działania i zwrócić odpowiednią odpowiedź.

Więcej informacji znajdziesz w artykule Obiekty zdarzeń.

Dodatki do Gmaila

Dodatek, który rozszerza tylko możliwości Gmaila. Dodatki do Gmaila działają na podstawie kart. Wiele funkcji, zachowań i szczegółów programistycznych używanych do tworzenia dodatków w Gmailu jest identycznych z tymi, które są stosowane przy tworzeniu dodatków do Google Workspace.

Więcej informacji znajdziesz w artykule Dodatki do Gmaila. Zapoznaj się też z sekcją Uaktualnianie opublikowanych dodatków, aby dowiedzieć się, jak przekształcić dodatek Gmaila w dodatek do Google Workspace.

Strona główna

Główna karta interfejsu dodatku. Strony główne są wyświetlane, gdy użytkownicy otworzą dodatek, i zezwalają mu na 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 otwiera). Wygląd i zachowanie strony głównej dodatku określasz tak jak każda inna karta.

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

Host lub host aplikacji

Aplikacja Google Workspace, która jest dodatkiem do Google Workspace, np. Gmail czy Kalendarz Google.

Oparta na języku HTML

Dodatek, którego interfejs jest zdefiniowany za pomocą HTML i CSS zamiast we wbudowanej usłudze karty Apps Script. Tylko starsze dodatki do Edytora są oparte na języku HTML.

Reguły podglądu linku uruchamiają się, gdy użytkownicy wchodzą w interakcję z adresem URL firmy zewnętrznej lub spoza Google w aplikacji hosta Google (np. w Dokumentach Google). Aktywowanie podglądu linków pozwala zdefiniować wzorce adresów URL, których podgląd chcesz wyświetlić z poziomu usługi lub interfejsu API, oraz skonfigurować treść podglądu, w tym element inteligentny i kartę podglądu. Aktywatory podglądu linków są konfigurowane w pliku manifestu projektu skryptu dodatku i dlatego są typem aktywatora w pliku manifestu.

Więcej informacji znajdziesz w artykule Wyświetlanie podglądu linków z elementami inteligentnymi.

Plik manifestu

Plik JSON dołączony do projektu Apps Script. Plik manifestu służy do definiowania informacji o projekcie, które muszą być poprawnie uruchomione przez skrypt. W przypadku dodatków do Google Workspace plik manifestu służy do określania hostów, które mogą być rozszerzane i udostępniane przez określone ustawienia interfejsu użytkownika.

Aktywator pliku manifestu

Aktywator zdefiniowany w pliku manifestu projektu, np. aktywator na stronie głównej lub aktywator kontekstowy. Aktywatory pliku manifestu są używane wyłącznie do tworzenia i wyświetlania nowych kart po wysłaniu żądania wyświetlenia strony głównej dodatku lub po wprowadzeniu kontekstu wymagającego aktualizacji wyświetlacza.

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

Karty niezwiązane z kontekstem

Karty, które pokazują treści, gdy użytkownik jest poza określonym kontekstem, na przykład podczas przeglądania wątków e-maili w Gmailu, ale jeszcze go nie otworzył. Strony główne są czymś w rodzaju karty niezwiązanej z kontekstem.

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

Element inteligentny

Element inteligentny dotyczy osoby, pliku, wydarzenia w kalendarzu lub innego elementu w aplikacji Google Workspace. Gdy użytkownik najedzie kursorem na element, może też wyświetlić podgląd dodatkowych treści w pliku lub linku. Na przykład gdy użytkownik najedzie kursorem na element w Prezentacjach Google, zobaczy zrzut ekranu ze slajdem, informacje o właścicielu prezentacji i o tym, czy już ją przeglądali.

Możesz skonfigurować dodatek, aby używać elementów inteligentnych do wyświetlania podglądu linków do usług innych firm lub usług innych firm. Zapoznaj się z artykułem Linki do podglądu w Dokumentach Google.

Aktywator

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

Więcej informacji znajdziesz w artykule o aktywatorach dodatkowych.

Aktywuj funkcję

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

Widżet

elementu interfejsu, np. przycisku, pola tekstowego lub pola wyboru; Karty tworzy się na podstawie sekwencji obiektów widżetów zdefiniowanych przez wbudowaną usługę karty Apps Script.

Więcej informacji znajdziesz w sekcji Widżety.

Funkcja obsługi widżetu

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

Więcej informacji znajdziesz w artykule Funkcje obsługi widżetów.