Słownik

W tej dokumentacji używamy tych terminów.

Dodatek do Kalendarza do obsługi rozmów wideo

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

Więcej informacji znajdziesz w artykule Dodatki do rozmów wideo w Kalendarzu. Więcej informacji o tym, jak przekonwertować dodatek do rozmów wideo w Kalendarzu na dodatek do Google Workspace, znajdziesz w artykule Uaktualnianie opublikowanych dodatków.

Karta

Pojedyncza „strona” interfejsu 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 sekcji Karty.

Na podstawie karty

Dodatek, którego interfejs użytkownika wyświetla się jako panel na pasku bocznym (lub na urządzeniach mobilnych jako inne okno aktywności dostępne w menu). Dodatek ma górny pasek narzędzi, który identyfikuje dodatek i wyświetla kartę, czyli „stronę” interfejsu dodatku.

Dodatki do Google Workspace są oparte na kartach.

Dane konferencji

Zestaw informacji, których Kalendarz Google potrzebuje, aby umożliwić użytkownikom tworzenie konferencji innych firm i dołączanie do nich za pomocą dodatku do Google Workspace lub dodatku do obsługi rozmów wideo w Kalendarzu.

Więcej informacji znajdziesz w sekcji Dane konferencji.

Rozwiązanie do obsługi konferencji

Reprezentacja konferencji innej firmy, 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 sekcji Rozwiązania konferencyjne.

Kontekst

Bieżący stan aplikacji hosta. Na przykład wiadomość, która jest obecnie otwarta w Gmailu, wydarzenie w Kalendarzu, które edytujesz, lub pliki na Dysku, które zostały przez Ciebie wybrane, są częścią bieżącego kontekstu aplikacji hosta. Kontekst wraz z innymi informacjami jest zbierany w obiekcie zdarzenia, który jest przekazywany do funkcji wyzwalającej jako parametr.

Wywoływanie kontekstowe

Praktyka definiowania wyzwalaczy, które są uruchamiane, gdy użytkownik wchodzi w określony kontekst, np. gdy otwiera wątek e-maili w Gmailu. Wywoływanie kontekstowe umożliwia dodatkowi wyświetlanie interfejsu odpowiedniego do danego kontekstu. Reguły kontekstowe są konfigurowane w manifeście projektu skryptu dodatku, dlatego są rodzajem reguły manifestu.

Dodatki do edytora

Pierwotny zestaw typów dodatków, które umożliwiały tylko rozszerzanie Dokumentów Google, Arkuszy, Formularzy lub Prezentacji Google. Dodatki do edytora nie są oparte na kartach. Wymagają od programisty utworzenia interfejsu z surowego 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, gdy żądane są strony główne, gdy dodatek wchodzi w konteksty, na które musi odpowiadać, lub w wyniku interakcji użytkownika z widgetami 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 użytkownika (np. informacji wpisanych przez użytkownika w widgetach interfejsu dodatku) do kodu po stronie serwera dodatku, który może następnie wykorzystać te informacje i zwrócić odpowiednią odpowiedź.

Więcej informacji znajdziesz w sekcji Obiekty zdarzeń.

Dodatki do Gmaila

Dodatek, który rozszerza tylko Gmaila. Dodatki do Gmaila są oparte na kartach. Większość funkcji, zachowań i szczegółów programowania używanych do tworzenia dodatków w Gmailu jest identyczna z tymi, które są używane do tworzenia dodatków do Google Workspace.

Więcej informacji znajdziesz w artykule Dodatki do Gmaila. Więcej informacji o tym, jak przekonwertować dodatek w Gmailu na dodatek do Google Workspace, znajdziesz w artykule Uaktualnianie opublikowanych dodatków.

Strona główna

Główna karta interfejsu dodatku. Strony główne są wyświetlane, gdy użytkownicy otwierają dodatek. Umożliwiają one wyświetlanie treści poza określonym kontekstem (np. gdy użytkownik przegląda wątki e-maili w Gmailu, ale nie otworzył żadnego z nich). Wygląd i działanie strony głównej dodatku określasz tak samo jak w przypadku innych kart.

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

Host lub aplikacja hosta

Aplikacja Google Workspace, którą rozszerza dodatek Google Workspace, np. Gmail lub Kalendarz Google.

oparte na HTML-u,

Dodatek, którego interfejs użytkownika jest zdefiniowany za pomocą HTML i CSS zamiast wbudowanej w Apps Script usługi kart. Tylko starsze dodatki do Edytora są oparte na HTML-u.

Aktywatory podglądu linku są uruchamiane, gdy użytkownicy wchodzą w interakcję z adresem URL innej firmy lub adresem URL spoza Google w aplikacji hosta Google, np. w Dokumentach Google. Wywoływanie podglądu linku umożliwia zdefiniowanie wzorców adresów URL, które mają być wyświetlane w podglądzie z Twojej usługi lub interfejsu API, oraz skonfigurowanie zawartości podglądu, w tym elementu inteligentnego i karty podglądu. Wywoływacze podglądu linku są konfigurowane w manifeście projektu skryptu dodatku, a więc są rodzajem wywoływacza manifestu.

Więcej informacji znajdziesz w artykule Wyświetlanie podglądu linku za pomocą elementów inteligentnych.

Plik manifestu

Plik JSON dołączony do projektu Apps Script. Plik manifestu służy do definiowania informacji o projekcie, których skrypt potrzebuje do prawidłowego działania. W przypadku dodatków do Google Workspace plik manifestu służy do określania, które hosty może rozszerzać dodatek, oraz do udostępniania niektórych ustawień elementu sterującego interfejsu.

Aktywator manifestu

Wywoływacz zdefiniowany w pliku manifestu projektu, np. wywoływacz strony głównej lub wywoływacz kontekstowy. Wywoływacze manifestu służą wyłącznie do tworzenia i wyświetlania nowych kart, gdy strona główna dodatku jest wymagana lub gdy dodatek wchodzi w kontekst, który wymaga aktualizacji wyświetlania.

Wywoływacze manifestu różnią się od innych wywoływaczy w Apps Script, ponieważ nie są wbudowane (jak proste wywoływacze) i nie można ich tworzyć programowo za pomocą usługi Script w Apps Script (jak wywoływacze instalowane).

Karty niekontekstowe

Karty, które wyświetlają treści, gdy użytkownik jest poza określonym kontekstem, np. podczas przeglądania wątków e-maili w Gmailu, ale nie otworzył żadnego z nich. Strony główne to rodzaj kart bez kontekstu.

Sekcja po prawej stronie interfejsu hosta, w której wyświetla się interfejs dodatku do Google Workspace. Paski boczne mogą też definiować dodatki do Gmaila i Edytora.

Element inteligentny

Element inteligentny to wzmianka o osobie, pliku, wydarzeniu w kalendarzu lub innym podmiocie w aplikacji Google Workspace. Gdy użytkownicy najedzie kursorem na przycisk, mogą też wyświetlić podgląd dodatkowych treści dotyczących pliku lub linku. Na przykład gdy użytkownicy najadą kursorem na kartę prezentacji Google, zobaczą zrzut ekranu slajdu, właściciela prezentacji oraz informację o tym, czy widzieli już tę prezentację.

Możesz skonfigurować dodatek tak, aby używał elementów inteligentnych do wyświetlania podglądu linków do usługi innej firmy lub usługi Google. Zobacz Wyświetlanie podglądu linków w Dokumentach Google.

Wyzwalacz

Warunek i automatyczna reakcja na zdarzenie zdefiniowane przez projekt Apps Script lub dodatek. Wywołania są aktywowane, gdy wystąpi powiązane z nimi zdarzenie (np. otwarcie dodatku), i powodują automatyczne wykonanie określonej funkcji Apps Script (funkcji wywołania). W przypadku dodatków do Google Workspace funkcje wywołujące często tworzą nowe karty, aby kontrolować, która część interfejsu dodatku jest wyświetlana. Reguły mogą mieć tylko niektóre typy zdarzeń.

Więcej informacji znajdziesz w sekcji dodatkowe aktywatory.

Funkcja aktywatora

Funkcja Apps Script w projekcie, która jest wykonywana w odpowiedzi na wywołanie wyzwalacza.

Widżet

Element interfejsu, taki jak przycisk, pole tekstowe lub pole wyboru. Karty są tworzone z ciągu obiektów widżetów zdefiniowanych przez wbudowaną usługę kart Apps Script.

Więcej informacji znajdziesz w rozdziale Widżety.

Funkcja obsługi widżetu

Funkcja, która łączy konkretny widżet z konkretnym obiektem działania. Każdy typ widżetu ma zestaw zdefiniowanych funkcji obsługi widżetu, 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 wywołuje wynikowe działanie, i są kluczowym elementem interaktywności widżetów.

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