Глоссарий

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В этой документации используются следующие термины.

Надстройка для конференций в календаре

Надстройка особого типа, позволяющая провайдерам конференц-связи отображать параметры конференц-связи в событиях Календаря Google. Для этих надстроек требуется хорошо разработанное решение для конференц-связи, к которому надстройка может подключиться. Из-за этого требования большинству разработчиков никогда не нужно создавать надстройку для конференций с календарем.

Дополнительную информацию см. в разделе Надстройки для конференц-связи с календарем . Также см. Обновление опубликованных надстроек, чтобы узнать, как преобразовать надстройку для конференций Календаря в надстройку Google Workspace.

Открытка

Одна «страница» пользовательского интерфейса надстройки. Карточки состоят из различных объектов-виджетов (кнопок, текстовых полей, заголовков и т. д.).

См. Карты для получения дополнительной информации.

Карточный

Надстройка, пользовательский интерфейс которой отображается в виде панели на боковой панели (или, на мобильных устройствах, в виде другого окна активности, доступ к которому можно получить через меню). Надстройка имеет верхнюю панель инструментов, которая идентифицирует надстройку и отображает карточку — по сути, «страницу» пользовательского интерфейса надстройки.

Дополнения Google Workspace основаны на карточках.

Данные конференции

Набор информации, необходимой Календарю Google, чтобы пользователи могли создавать сторонние конференции и присоединяться к ним, поддерживаемые надстройкой Google Workspace или надстройкой для проведения конференций Календаря.

Дополнительные сведения см. в разделе Данные конференции .

Конференц-решение

Представление сторонней конференции, которое можно создать из Календаря Google с помощью надстройки Google Workspace или надстройки для проведения конференций Календаря.

Дополнительную информацию см. в разделе Решения для конференц- связи.

Контекст

Текущее состояние хост-приложения. Например, какое сообщение в настоящее время открыто в Gmail, какое событие календаря вы редактируете или какие файлы на Диске вы выбрали, являются частью текущего контекста основного приложения. Контекст вместе с другой информацией собирается в объект события, который передается функции триггера в качестве параметра.

Контекстный запуск

Практика определения триггеров, которые срабатывают, когда пользователь входит в определенный контекст, например, когда он открывает ветку электронной почты в Gmail. Контекстный запуск позволяет вашей надстройке предоставлять пользовательский интерфейс, соответствующий этому контексту. Контекстные триггеры настраиваются в манифесте проекта сценария надстройки и, таким образом, являются типом триггера манифеста .

Надстройки редактора

Исходный набор типов надстроек, которые допускали только расширения Google Docs, Sheets, Forms или Slides. Надстройки редактора не основаны на карточках; скорее, они требовали от разработчика создания пользовательского интерфейса из необработанного HTML и CSS. Каждая надстройка редактора может расширять только одно хост-приложение.

Дополнительные сведения см. в разделе Надстройки редактора .

Объект события

Объект JSON, который автоматически создается при запросе домашних страниц, когда надстройка входит в контексты, на которые она должна реагировать, или в результате взаимодействия пользователя с виджетами в интерфейсе надстройки. После создания объекты событий передаются указанной триггерной функции или функции обратного вызова. Целью объектов событий является передача информации из клиентской среды пользователя (например, информации, которую он ввел в виджеты интерфейса надстройки) в серверный код надстройки, который затем может действовать на основе этой информации и вернуть соответствующий ответ.

Дополнительные сведения см. в разделе Объекты событий .

Дополнения Gmail

Дополнение, расширяющее возможности только Gmail. Надстройки Gmail основаны на картах. Многие функции, поведение и детали разработки, используемые для создания надстроек Gmail, идентичны тем же деталям, которые используются для создания дополнений Google Workspace.

Дополнительную информацию см. в разделе Надстройки Gmail . Также см. Обновление опубликованных надстроек, чтобы узнать, как преобразовать надстройку Gmail в надстройку Google Workspace.

Домашняя страница

Корневая карточка пользовательского интерфейса надстройки. Домашние страницы отображаются, когда пользователи открывают надстройку, и позволяют вашей надстройке отображать контент вне определенного контекста (например, когда пользователь просматривает свою ветку электронной почты в Gmail, но не открыл ее). Вы определяете внешний вид и поведение домашней страницы надстройки, как и любой другой карты.

Дополнительную информацию см. в разделе Домашние страницы .

Хост или хост-приложение

Приложение Google Workspace, расширяемое надстройкой Google Workspace, например Gmail или Календарь Google.

на основе HTML

Дополнение, пользовательский интерфейс которого определяется с помощью HTML и CSS вместо встроенного сервиса карточек Apps Script. Только старые надстройки редактора основаны на HTML.

Манифест

Файл JSON, прикрепленный к проекту скрипта приложений. Манифест используется для определения информации о проекте, которая необходима сценарию для правильной работы. Для надстроек Google Workspace манифест используется, чтобы указать, какие хосты надстройка может расширять, и предоставить определенные параметры управления пользовательским интерфейсом.

Триггер манифеста

Триггер, определенный в манифесте проекта, например триггер домашней страницы или контекстный триггер. Триггеры манифеста используются исключительно для создания и отображения новых карточек, когда запрашивается домашняя страница надстройки или надстройка входит в контекст, требующий обновления отображения.

Триггеры манифеста отличаются от других триггеров в Apps Script, поскольку они не являются встроенными (например, простые триггеры ) и не могут быть созданы программно с помощью службы скриптов Apps Script (например, устанавливаемые триггеры ).

Неконтекстные карточки

Карточки, которые показывают контент, когда пользователь находится вне определенного контекста; например, при просмотре своих веток электронной почты в Gmail, но не открыл ни одной. Домашние страницы — это своего рода неконтекстная карточка.

Раздел справа от пользовательского интерфейса хоста, в котором отображается пользовательский интерфейс надстройки Google Workspace. Надстройки Gmail и редактора также могут определять боковые панели.

Курок

Условие и автоматический ответ на событие, определенные проектом или надстройкой Apps Script. Триггеры срабатывают при возникновении связанного с ними события (например, при открытии надстройки) и вызывают автоматическое выполнение указанной функции скрипта приложений (триггерной функции). Для надстроек Google Workspace триггерные функции часто создают новые карты, чтобы управлять отображаемой частью пользовательского интерфейса надстройки. Только определенные типы событий могут иметь триггеры.

Дополнительную информацию см. в разделе Дополнительные триггеры .

Триггерная функция

Функция скрипта приложений в проекте, которая выполняется в ответ на срабатывание триггера.

Виджет

Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карточки создаются из последовательности объектов-виджетов, определяемых встроенной службой карточек Apps Script.

Дополнительные сведения см. в разделе Виджеты .

Функция обработчика виджета

Функция, которая связывает определенный виджет с определенным объектом действия . Каждый тип виджета имеет набор определенных функций обработчика виджетов, которые он может использовать для подключения к действиям. Функции обработчика виджетов определяют, какое взаимодействие с пользователем инициирует результирующее действие, и являются важным компонентом интерактивности виджета.

Дополнительные сведения см. в разделе Функции обработчика виджетов .